> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Call API ノード

> Workflow を任意の外部 API エンドポイントに接続します

**Call API** ノードは、Workflow を任意の外部 API エンドポイントに接続します。このステップを使用して、データの取得、外部サービスのトリガー、Workflow の入力の拡充、社内のシステムやツールとの連携を行えます。

このノードは、**GET** と **POST** の両方のリクエスト、オプションの認証、および (POST リクエストの場合) JSON 形式のリクエストボディをサポートしています。

<img src="https://mintcdn.com/profound-37face47/LU_swtbqvG5kIsMS/images/agents/nodes/call-api-1.png?fit=max&auto=format&n=LU_swtbqvG5kIsMS&q=85&s=d7ebced3d931337a4f07d806de54557f" alt="call api.png" width="1920" height="1200" data-path="images/agents/nodes/call-api-1.png" />

## このノードを使用する場面

Call API は、次のようなタスクに使用します。

* サードパーティのツール、CRM、CMS システム、分析プラットフォームからデータを取得する
* 外部の自動化や Workflows をトリガーする
* 後続の LLM ステップで使用する構造化データを取得する
* 別の場所でホストされているカスタムのビジネスロジックで Workflow の実行を強化する
* Profound Workflows を社内の API やマイクロサービスと連携する

## ノードの設定

Call API ノードを選択すると、Workflow Builder の右側に設定パネルが開きます。

### Method (必須)

リクエストの HTTP メソッドを選択します。

* **GET** – API エンドポイントからデータを取得します
* **POST** – エンドポイントにデータを送信します。リクエストボディを含めることができます

呼び出す API に合ったメソッドを選択してください。

### URL (必須)

API エンドポイントの完全な URL を入力します。

次のことができます。

* 静的な URL を貼り付ける
* `/` を使用して変数を動的に挿入し、入力や前の Workflow ステップを参照する

例:

* `https://api.example.com/users/{{user_id}}`
* `https://internal.mycompany.com/search?q={{topic}}`

## POST リクエストの追加設定

メソッドが **POST** の場合、追加のフィールドが表示されます。

### Request Body

リクエストで送信する JSON ペイロードを入力します。これは POST リクエストでは必須です。

ペイロードの例:

```text expandable wrap theme={null}
{
  "userId": 1234
  "action": "create",
  "payload": {
    "firstName": "Jack",
    "email":"jack@example.com"
  }
}
```

変数は `/` を使用して挿入できます。

### Content Type (POST の場合は必須)

リクエストボディのコンテンツタイプを選択します。

* **None**
* **Application/Json**

ほとんどの API は `application/json` を想定しています。

## Output Label

API レスポンスにわかりやすいラベルを付けます。これは、後続のノードが参照する変数名になります。

例:

* `api_response`
* `user_record`
* `external_data`

## 詳細設定

**Advanced settings** を選択して、リクエストの認証を設定します。<br />一般に公開されていない API には認証が必要です。

### Authentication Type (必須)

認証方式を選択します。

* **None** – 認証なし
* **Basic** – ユーザー名とパスワード
* **Bearer** – Bearer トークン
* **API Key** – カスタムの API キーヘッダー

オプションごとに、異なる必須フィールドが表示されます。

#### Basic 認証

フィールド:

* Username
* Password

#### Bearer 認証

フィールド:

* Bearer Token

#### API Key 認証

フィールド:

* Header Name
* API Key Value

例:

* Header Name: `X-API-Key`
* API Key Value: `<your_key_here>`

呼び出す API が想定しているフィールド名を使用してください。

## 出力

Call API ノードは、API からのレスポンスボディ全体をテキストとして返します。この出力は、次のものに渡すことができます。

* 解析、抽出、要約を行う LLM ステップ
* ロジックや変換のノード
* 後続の API 呼び出し
* 構造化または半構造化された外部データを必要とするあらゆるステップ

出力は、JSON、HTML、プレーンテキスト、または API が返す任意のコンテンツタイプです。

## 使用例

### 1. ユーザープロフィールのデータを取得する

1. 次の設定で **Call API** ノードを追加します。
   * Method: GET
   * URL: `https://api.example.com/users/{{user_id}}`
   * Output Label: `user_profile`
2. 分析や変換のために、\{\{user\_profile}} を LLM ステップに渡します。

### 2. Workflow のデータを外部サービスに送信する

1. 次の設定で **Call API** ノードを追加します。
   * Method: POST
   * URL: `https://hooks.example.com/events`
   * Content Type: Application/Json

```text wrap theme={null}
Request Body:{
  "transcript": "{{video_transcript}}", 
  "summary": "{{summary}}"
}
```

* Output Label: `event_response`

### 3. 認証が必要な API を使用する

1. **Advanced settings** で、適切な認証タイプを選択します。
2. 認証情報 (Bearer Token や API Key など) を指定します。
3. 必要に応じて GET または POST を使用し、保護されたデータを取得します。

## ベストプラクティス

* ノードを設定する前に、API が想定するメソッド、ヘッダー、ペイロードの構造、認証要件を必ず確認してください。
* 変数を使用して URL やリクエストボディを動的に構築すると、Workflows の柔軟性が高まります。
* JSON を送信する場合は、正しい形式になっていることを確認してください。不正な形式の JSON はリクエストの失敗につながります。
* 特に複数の API 呼び出しを連結する場合は、出力ラベルをわかりやすくしてください。

## トラブルシューティング

### API がエラーを返す

次の点を確認してください。

* URL が正しいか
* 必須のクエリパラメーター
* 認証情報
* JSON ボディの構造 (POST の場合)

### レスポンスが空、または想定外の内容である

API は HTML のエラーページやラッパーオブジェクトを返す場合があります。Prompt LLM ステップを使用して、関連する部分を解釈または抽出してください。

### 変数が解決されない

`/` を入力して変数ピッカーから選択し、変数を挿入してください。