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

低代码工作流中的 HTTP 请求节点允许用户通过 HTTP 协议发送请求到外部服务，实现数据的获取、提交和交互。支持多种 HTTP 请求方法，并允许用户配置请求参数、请求头、鉴权信息、请求体等，以满足不同的数据交互需求。此外，HTTP 请求节点还提供了超时设置、重试机制，确保请求的可靠性和数据的正确处理。
HTTP 请求节点的作用如下：

* **数据获取**：从外部服务获取数据，例如从 API 获取用户信息、天气数据等。
* **数据提交**：向外部服务提交数据，例如提交表单数据等。
* **数据更新**：更新外部服务中的数据，例如更新用户信息、修改订单状态等。
* **数据删除**：删除外部服务中的数据，例如删除用户账户、删除订单等。

## 节点配置 {#70e3ec4d}
在使用 HTTP 请求节点实现数据获取、提交等功能时，通常需要配置 API、请求参数、请求头、鉴权、请求体等参数。为了简化这一配置过程，提高开发效率，HTTP 请求节点支持导入 cURL 功能，开发人员可以快速将 cURL 命令中的参数导入到 HTTP 请求节点。
<!-- @cols-width: 130,677 -->
| | | \
|**配置项** |**说明** |
|---|---|
| | | \
|API |配置 API 请求地址和方法，支持以下请求方法：  |\
| | |\
| |* **GET**：用于请求从外部服务获取数据，例如调用 API 获取用户信息、天气数据等。  |\
| |* **POST**：用于向服务器提交数据，例如提交表单。  |\
| |* **HEAD**：类似于 GET 请求，但服务器不返回请求的资源主体，只返回响应头。  |\
| |* **PATCH**：用于在请求-响应链上的每个节点获取传输路径。  |\
| |* **PUT**：用于向服务器上传资源，通常用于更新已存在的资源或创建新的资源。  |\
| |* **DELETE**：用于请求服务器删除指定的资源。  |\
| | |\
| |配置API请求地址时，可以使用变量来动态指定参数，通过输入`{{`即可唤出并使用该变量。 |\
| |:::tip 说明 |\
| |建议使用域名访问，`ip：port` 形式可能被拦截。 |\
| |::: |
| | | \
|请求参数 |请求参数是附加在 URL 后面的键值对，用于向服务器传递额外的信息。例如，在搜索请求中，可以通过请求参数传递搜索关键词。 |
| | | \
|请求头 |请求头包含客户端的信息，如 User-Agent、Accept 等。通过配置请求头，可以指定客户端的类型、接受的数据格式等信息。 |
| | | \
|鉴权 |通过配置鉴权信息，可以确保请求的安全性，防止未授权的访问，支持 Bearer Token 和自定义鉴权： |\
| | |\
| |* **Bearer Token**：输入 Token 值，通常用于 OAuth2 等认证方式。 |\
| |* **自定义鉴权**：配置自定义的认证信息，包括： |\
| |   * **Key**：认证键。 |\
| |   * **Value**：认证值。 |\
| |   * **Add To**：选择将认证信息添加到请求头（Header）或查询参数（Query）。 |
| | | \
|请求体 |请求体是 POST 请求中包含的数据，可以是表单数据、JSON 数据等。根据不同的请求类型和数据格式，可以选择相应的请求体格式，例如 form-data、x-www-form-urlencoded、raw text、JSON 等。 |\
| |选择 JSON 格式时，你需要单击 **Edit JSON**，才能输入请求体。 |
| | | \
|超时设置 |超时时间指节点运行的最大耗时，如果超过此时长，则判断为节点运行超时。通过配置超时设置，可以避免长时间等待，提高工作流的响应速度。 |\
| |默认情况下，HTTP 节点的超时时间默认为 120s，即 2 分钟；最长可设置为 600 秒，即 10 分钟。 |
| | | \
|重试次数 |节点运行超时或异常时，默认重试 3 次，最大可设置为 10 次。 |
| | | \
|输出 |输出变量包括响应体、状态码和响应头。 |
| | | \
|异常忽略 |支持**异常忽略**功能。开启此功能后，如果试运行工作流时此节点运行失败，工作流不会中断，而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容，则使用此节点预先配置的默认输出内容。 |

## 示例 {#a3a8ddf1}
例如通过 HTTP 请求节点调用扣子编程的[查看智能体列表](https://www.coze.cn/docs/developer_guides/published_bots_list)接口，可以获取指定空间发布到 Agent as API 渠道的智能体列表。
![Image=2278x420](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/beee23905d344b7c9075e6fed09c5412~tplv-goo7wpa0wc-image.image)
节点配置如下：
<!-- @cols-width: 113,539,210 -->
| | | | \
|**节点类型** |**说明** |**示例** |
|---|---|---|
| | | | \
|开始节点 |工作流的起始节点，本示例需要配置输入参数`space_id`，用于指定要查看的空间。 |![Image=642x336](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/303efc15b280464893fab193a3ec6225~tplv-goo7wpa0wc-image.image) |
| | | | \
|HTTP 请求节点 |用于调用查看智能体列表接口，获取指定空间发布到 Agent as API 渠道的智能体列表，需要根据[查看智能体列表](https://www.coze.cn/docs/developer_guides/published_bots_list)的接口要求配置： |\
| | |\
| |* API：请求地址为`https://api.coze.cn/v1/space/published_bots_list`，方法为 GET。 |\
| |* 请求参数：定义参数`space_id`，并引用开始节点的输入参数`space_id`。 |\
| |* 请求头：需要设置以下参数： |\
| |   * Content-Type：固定值 **application/json。** |\
| |   * Authorization：用于验证客户端身份的访问令牌，本示例以个人访问令牌为例，取值格式为 Bearer $Access_Token*。​*个人访问令牌可参考[添加个人访问令牌](/developer_guides/pat)。 |\
| |* 鉴权：本示例无需鉴权。 |\
| |* 请求体：本示例设置为 **none**。 |\
| |   设置为 **JSON** 时，如果引用的变量为 string 类型，需要使用双引号`""`包裹变量。具体示例，请参考[如何处理"[720712042] Body is not json" 错误？](/guides/http_node#87a72228)。 |\
| |   :::tip 说明 |\
| |   在 JSON 格式的请求体中引用变量时，你可以输入 `{`来引用变量。 |\
| |   ::: |\
| |* 超时设置、重试次数、输出：本示例保持默认配置。 |![Image=357x1031](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/291b3f06cfa54da193708e3472d94856~tplv-goo7wpa0wc-image.image) |
| | | | \
|结束节点 |选择返回变量模式，定义 output 参数，引用 HTTP 请求节点的输出参数 body。 |![Image=360x245](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0134daf96acd4c9096bc8cdee16e7c07~tplv-goo7wpa0wc-image.image) |

## 常见问题 {#5c46703e}
### 如何解决 HTTP 请求超时问题？ {#c78fd4a2}
可以通过配置超时设置来解决 HTTP 请求超时问题。合理设置超时时间，可以避免请求长时间等待。
### 如何处理 HTTP 请求失败的情况？ {#dc08479f}
可以通过配置重试次数设置来处理 HTTP 请求失败的情况。设置重试次数，可以提高请求的成功率。
### 如何确保 HTTP 请求的安全性？ {#ffd6f56c}
可以通过配置鉴权信息来确保 HTTP 请求的安全性。    
### 如何处理"[720712042] Body is not json" 错误？ {#87a72228}
设置**请求体**为 **JSON** 格式时，如果请求体为不符合 JSON 格式规范，将出现 `"[720712042] Body is not json"` 错误。为解决此问题，请仔细检查请求体满足以下要求：

* 请求体内容为有效的 JSON 结构。
* 如果请求体中引用了变量，当变量为 `string` 类型时，需使用双引号 `""` 包裹变量。

![Image=384x187](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/32d8d3c2a33943978dd3f5e7e4de2ff7~tplv-goo7wpa0wc-image.image)