カスタムAPIコール(Custom API Call)

このピースでできること

  • Jira CloudのREST APIに対して、任意のエンドポイントへHTTPリクエストを送信します。
  • 標準のピースにないAPI操作を行いたい場合に利用します。
 

Jira Cloud の接続方法

workrun と Jira Cloud を接続するには、Instance URLメールアドレスAPI トークン の 3 つが必要です。

ステップ 1:Atlassian API トークンを作成する

  1. Atlassian アカウント設定 にアクセスします。
  1. 「Create API token」 をクリックします。
  1. トークン名を入力し(例:)、「Create」 をクリックします。
  1. 表示されたトークンをコピーします。
⚠️ トークンはこの画面でしか表示されません。必ずコピーして保管してください。

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

  1. workrun で Jira Cloud のアクション/トリガーをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 以下をそれぞれ入力します:
      • Instance URL: の形式で入力
      • Email: Jira のログイン用メールアドレス
      • API Token: ステップ 1 でコピーしたトークン
  1. 「保存」 をクリックして接続を完了します。
 

ピースの設定項目

1. HTTPメソッド(必須)

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

2. URL(必須)

  • APIエンドポイントのパスを指定します。
  • ベースURLは {instanceUrl}/rest/api/3 です。

3. ヘッダー(任意)

  • 追加したいヘッダーがある場合に指定します。

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

  • URLクエリとして付けたいパラメータを指定します。

5. ボディ(任意)

  • POSTやPUTなどで送信するJSONボディを指定します。