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

# REST API

> AIエージェントを外部サービスやAPIに接続します。

<img src="https://mintcdn.com/gidrai/La57oM6sCecLAz60/images/ai-studio/rest-api-clean-workflow.png?fit=max&auto=format&n=La57oM6sCecLAz60&q=85&s=bb0d39eef7917f77b186c570c5ff7f7e" alt="REST APIノードワークフロー" width="1385" height="922" data-path="images/ai-studio/rest-api-clean-workflow.png" />

## 概要

**REST API** ノードを使用すると、ワークフローは標準のHTTPリクエストを使用して外部システムと対話できます。これは、サードパーティサービスからデータを取得したり、外部アクションをトリガーしたり、独自のバックエンドAPIと統合したりするために不可欠です。

## 設定

<img src="https://mintcdn.com/gidrai/La57oM6sCecLAz60/images/ai-studio/rest-api-config-top.png?fit=max&auto=format&n=La57oM6sCecLAz60&q=85&s=c709fb666a1df70bf7670553b9db0a0b" alt="設定トップ" style={{ width: '300px' }} width="322" height="428" data-path="images/ai-studio/rest-api-config-top.png" />

<img src="https://mintcdn.com/gidrai/La57oM6sCecLAz60/images/ai-studio/rest-api-config-middle.png?fit=max&auto=format&n=La57oM6sCecLAz60&q=85&s=7553101f59c5bba930c15bf8a8229e1f" alt="設定ミドル" style={{ width: '300px' }} width="322" height="428" data-path="images/ai-studio/rest-api-config-middle.png" />

<img src="https://mintcdn.com/gidrai/La57oM6sCecLAz60/images/ai-studio/rest-api-config-middle-post.png?fit=max&auto=format&n=La57oM6sCecLAz60&q=85&s=ec356cdcb7d78afec6d1badb679eb910" alt="設定ミドル" style={{ width: '300px' }} width="322" height="139" data-path="images/ai-studio/rest-api-config-middle-post.png" />

<img src="https://mintcdn.com/gidrai/La57oM6sCecLAz60/images/ai-studio/rest-api-config-bottom.png?fit=max&auto=format&n=La57oM6sCecLAz60&q=85&s=dddb002bf53e8e4f4798b1d00fbc85d0" alt="設定ボトム" style={{ width: '300px' }} width="322" height="428" data-path="images/ai-studio/rest-api-config-bottom.png" />

### リクエスト詳細

* **リクエストタイプ**: HTTPメソッド（GET, POST, PUT, DELETE, PATCH）を選択します。
* **リクエストURL**: エンドポイントURL。前のステップからの動的変数をサポートします（例：`https://api.example.com/users/{{userId}}`）。

### パラメータとヘッダー

* **ヘッダー**: `Authorization` や `Content-Type` などのカスタムヘッダーを追加します。
* **クエリパラメータ**: URLに追加されるキーと値のペア（例：`?limit=10`）。
* **パスパラメータ**: URLパス内のプレースホルダーを置き換える変数。

### リクエストボディ (POST/PUT/PATCH)

* **ボディ**: リクエストとともに送信するペイロード。これは生のJSONまたはテキストにすることができます。`{{variable_name}}` 構文を使用して、ワークフロー変数をボディに注入できます。

### 詳細設定

* **タイムアウト**: 応答を待機する最大時間（秒）。
* **再試行**: 失敗した場合にリクエストを再試行する回数。

### 出力

* **出力変数**: その後のノードで使用するために、JSON応答のフィールドをワークフロー変数にマップする変数を定義します。
