カスタムAPI呼び出し

このピースでできること

  • カオナビ API の任意のエンドポイントにカスタムな API リクエストを実行します。
  • 認証ヘッダー(Kaonavi-Token)と Content-Type は自動付与されます。

カオナビ の接続方法

workrun と カオナビ を接続するには、カオナビ の Consumer KeyConsumer Secret が必要です。

ステップ 1:Consumer Key と Consumer Secret を取得する

  1. カオナビにログインし、管理者機能トップ > 公開API v2 情報 > 認証情報 を開きます。
  1. 認証情報の「編集」から、workrun で使用する機能(メンバー情報の取得 / 登録 / 更新、Webhook 設定 など)を有効化します。
  1. 同画面で Consumer KeyConsumer Secret を确認し、コピーしておきます。

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

  1. workrun で カオナビ のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「Consumer Key」 フィールドに、ステップ 1でコピーした Consumer Key を貼り付けます。
  1. 「Consumer Secret」 フィールドに、ステップ 1でコピーした Consumer Secret を貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ピースの設定項目

1. URL(必須)

2. メソッド(必須)

  • HTTP メソッドを選択します。

3. ヘッダー(任意)

  • 追加の HTTP ヘッダーを入力します。認証ヘッダー(Kaonavi-Token)と Content-Type は自動付与されるため記入不要です。

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

  • URL に付与するクエリパラメータを入力します。

5. ボディタイプ(任意)

  • リクエストボディの形式を選択します(JSON / Raw / フォームデータ / なし)。

6. ボディ(任意)

  • リクエストボディを入力します。ボディタイプに応じた形式で入力してください。

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

  • 有効にすると、リクエストが失敗してもフロー実行を継続します。

8. 応答はバイナリですか?(任意)

  • PDF・画像などのバイナリファイルを取得する場合は有効にします。

9. タイムアウト(秒)(任意)

  • リクエストのタイムアウト秒数を指定します。未入力の場合はデフォルト値が使用されます。

10. リダイレクトをフォローする(任意)

  • HTTP リダイレクトを自動的にフォローする場合は有効にします。