カスタムAPI呼び出し
このピースでできることカオナビ の接続方法ステップ 1:Consumer Key と Consumer Secret を取得するステップ 2:workrun に接続を追加するピースの設定項目1. URL(必須)2. メソッド(必須)3. ヘッダー(任意)4. クエリパラメータ(任意)5. ボディタイプ(任意)6. ボディ(任意)7. 失敗時にエラーにしない(任意)8. 応答はバイナリですか?(任意)9. タイムアウト(秒)(任意)10. リダイレクトをフォローする(任意)
このピースでできること
- カオナビ API の任意のエンドポイントにカスタムな API リクエストを実行します。
- 認証ヘッダー(Kaonavi-Token)と Content-Type は自動付与されます。
カオナビ の接続方法
workrun と カオナビ を接続するには、カオナビ の Consumer Key と Consumer Secret が必要です。
ステップ 1:Consumer Key と Consumer Secret を取得する
- カオナビにログインし、管理者機能トップ > 公開API v2 情報 > 認証情報 を開きます。
- 認証情報の「編集」から、workrun で使用する機能(メンバー情報の取得 / 登録 / 更新、Webhook 設定 など)を有効化します。
- 同画面で Consumer Key と Consumer Secret を确認し、コピーしておきます。
ステップ 2:workrun に接続を追加する
- workrun で カオナビ のアクションをフローに追加します。
- 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
- 「Consumer Key」 フィールドに、ステップ 1でコピーした Consumer Key を貼り付けます。
- 「Consumer Secret」 フィールドに、ステップ 1でコピーした Consumer Secret を貼り付けます。
- 「保存」 をクリックして接続を完了します。
ピースの設定項目
1. URL(必須)
- リクエスト先の URL を入力します。完全な URL またはベース URL(https://api.kaonavi.jp/api)からの相対パスを指定できます。
2. メソッド(必須)
- HTTP メソッドを選択します。
3. ヘッダー(任意)
- 追加の HTTP ヘッダーを入力します。認証ヘッダー(Kaonavi-Token)と Content-Type は自動付与されるため記入不要です。
4. クエリパラメータ(任意)
- URL に付与するクエリパラメータを入力します。
5. ボディタイプ(任意)
- リクエストボディの形式を選択します(JSON / Raw / フォームデータ / なし)。
6. ボディ(任意)
- リクエストボディを入力します。ボディタイプに応じた形式で入力してください。
7. 失敗時にエラーにしない(任意)
- 有効にすると、リクエストが失敗してもフロー実行を継続します。
8. 応答はバイナリですか?(任意)
- PDF・画像などのバイナリファイルを取得する場合は有効にします。
9. タイムアウト(秒)(任意)
- リクエストのタイムアウト秒数を指定します。未入力の場合はデフォルト値が使用されます。
10. リダイレクトをフォローする(任意)
- HTTP リダイレクトを自動的にフォローする場合は有効にします。