カスタムAPI呼び出し

このピースでできること

  • HRMOS勤怠の特定のエンドポイントへのカスタムAPIコールを実行します。
  • 標準アクションで対応していないエンドポイントも直接呼び出すことができます。

HRMOS勤怠 の接続方法

workrun と HRMOS勤怠 を接続するには、HRMOS勤怠 の Secret Key会社URL が必要です。

ステップ 1:Secret Key と会社URL を確認する

  1. HRMOS勤怠に管理者アカウントでログインします。
  1. 「システム管理」›「システム設定」›「編集」を開きます。
  1. 表示される Secret Key をコピーしておきます。
      • Secret Key の有効期限は発行から3ヶ月です。期限切れ前に再発行し、workrun の接続を更新してください。
  1. ログインURL(例: )の の部分が 会社URL です。メモしておきます。

ステップ 2:workrun に接続を追加する

  1. workrun で HRMOS勤怠 のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「Secret Key」 フィールドに、ステップ 1 でコピーした Secret Key を貼り付けます。
  1. 「会社URL」 フィールドに、ステップ 1 で確認した会社URL( の部分)を入力します。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. URL(必須)

  • 完全なURLまたはベースURL()からの相対パスを入力します。

2. メソッド(必須)

  • HTTPメソッドを選択します(GET / POST / PUT / PATCH / DELETE / HEAD)。

3. ヘッダー(任意)

  • 追加のHTTPヘッダーを指定します。認証ヘッダーは接続情報から自動的に注入されるため、入力不要です。

4. クエリパラメータ(任意)

  • URLに追加するクエリパラメータを指定します。

5. ボディ(任意)

  • リクエストボディをJSON形式で入力します(POST/PUTときに使用)。

6. 失敗時にエラーにしない(任意)

  • ONにするとAPIエラー時もフローを継続します。エラー発生しても後続の処理を続けたい場合に使用します。