HTTP 请求节点

定义

HTTP 请求节点是一个功能组件，用于与外部服务器或 API 进行通信。它通过发送标准 HTTP 请求实现外部数据和性能数据的交换与操作，适用于获取外部数据、创建 Webhook、生成图像和下载文件等场景。

快速开始/使用方法：

节点配置详情：在 GoInsight.AI 中，右键点击选择“添加节点”以将 HTTP 请求节点添加至工作流。

1. 配置 HTTP 请求的 API 参数

API：HTTP 节点的 API 模块提供了制作 API 调用的便捷界面。用户只需输入目标 API 地址，并从六种标准 HTTP 方法中选择适当的请求方法：

GET：用于向服务器请求获取特定资源。

POST：用于向服务器提交数据，通常用于提交表单或上传文件。

HEAD：类似于 GET 请求，但服务器仅返回请求资源的响应头而不返回资源主体。

PATCH：用于对现有资源进行局部更新。

PUT：用于向服务器上传资源，通常用于更新现有资源或创建新资源。

DELETE：用于请求服务器删除指定资源。

常见 HTTP 响应状态码

在 HTTP 请求过程中，服务器返回不同的状态码以表明请求的成功、失败或需要进一步操作。以下是常见 HTTP 状态码的分类及其处理方法，可根据需要进行处理：

2. 目标 URL

输入目标 URL 或输入 / 插入变量。仅支持 HTTP 和 HTTPS 协议。

例如，使用 GET 方法访问 AirDroid 网站：

• 通过输入 URL：键入 https://www.airdroid.com



• 通过插入变量：例如，键入 / 并选择系统变量 Query。这会将用户的查询内容作为请求节点的目标 URL。

注意

运行此步骤 (Run This Step) 是一个节点调试功能，允许开发人员独立执行并验证工作流中的特定节点。点击界面右上角的“运行此步骤”按钮时，仅执行当前选择的节点，有助于精准定位问题。

跟随此节点 (Follow This Node) 也是一个节点调试功能。启用此功能后，系统会自动将此节点使用的所有变量标记为焦点变量，并实时显示其摘要信息在调试面板中，有助于快速掌握工作流状态。

3. 配置 HTTP 请求头和 Params

1) Headers 是元数据，它们附在请求或响应上。它们提供关于请求的额外信息，类似于信封上的邮票和地址提供关于信件的额外细节。

功能：包含关于请求的补充信息，例如请求类型、发送者信息、数据格式等。

• Content-Type：指定正在发送的数据格式（例如，application/json、application/x-www-form-urlencoded 等）。
• Authorization：包含 API 的身份验证信息，例如令牌。
• 也可以使用其他自定义请求头。

2) Params 是键值对，附加到 URL 后用于传递额外的查询信息。这就像在餐厅告诉服务员您想要额外的盐或选择不同的配菜。

功能：用于过滤或指定请求的某些条件。

如果有多组 Headers/Params，您可以点击右上角的“+”添加更多，点击右下角的“删除”移除它们。

4. 配置 HTTP 请求的主体内容

主体是请求中传输的实际数据内容。它就像一封信的正文，包含您想要传达的主要信息。

功能：包含需要发送到服务器的数据，例如表单信息、文件内容等。

主体格式：HTTP 节点为主体格式提供了灵活的配置，支持五种常见数据格式以适应不同的接口要求：

1. None: 表示发送请求时没有附加任何数据。这种情况通常发生在以下情况：

• GET 请求：GET 请求通常用于从服务器获取数据而不是发送数据，因此它们通常不需要请求主体。在这种情况下，body 为 None 是正常的。

DELETE 请求：类似于 GET 请求，DELETE 请求通常用于删除资源，并且通常不需要请求主体。

不需要数据：某些 API，例如简单的触发操作或状态查询，被设计为不需要请求主体。

默认设置：如果请求类型支持请求主体（如 POST 或 PUT），但在特定情况下不需要任何数据，则主体也可以设置为 None。

2. form-data: 一种用于发送表单数据的格式，通常用于文件上传。

• 用法：主要用于需要文件上传的场景，因为它既可以处理二进制数据也可以处理文本数据。
• 实现方式：使用
  multipart/form-data
  作为
  Content-Type
  ，每个字段都有自己的内容描述和边界。
• 示例：在 HTML 表单中选择文件上传时使用。

3. x-www-form-urlencoded: 一种将表单数据编码为键值对的格式，以 URL 编码格式发送数据。

• 用法：适用于发送简单的表单数据，通常用于 POST 请求。
• 实现方式：数据以
  key1=value1&key2=value2
  的格式在请求主体中发送，并对特殊字符进行编码。
• 示例：提交 HTML 表单时默认使用此格式。

4. raw text: 指发送不带特定编码格式的纯文本数据。

• 用法：适用于需要发送纯文本数据的场景。
• 实现方式：
  Content-Type
  可以指定为
  text/plain
  以直接发送未编码的文本。
• 示例：发送简单的文本消息或日志数据。

5. JSON: 用于发送结构化 JSON 数据。

• 用法：广泛用于
  RESTful APIs
  ，因为 JSON 易于阅读和解析。
• 实现方式：使用
  application/json
  作为
  Content-Type
  ，数据以 JSON 格式发送。
• 示例：发送复杂的对象或数组数据，例如 {"name": "John", "age": 30}。

5. HTTP 请求超时设置

超时设置是一个阈值参数，控制请求等待响应的最长时间。您可以根据需要设置超时时长（以秒为单位），默认值为 30 秒。

功能：它有助于防止工作流卡住或延迟；强制终止无限期等待响应的请求。

6. 错误处理

为节点配置错误处理策略。如果在节点执行期间发生阻止节点产生结果的严重错误，将应用此策略以防止整个工作流中断。

有关错误处理机制的更多详细信息，请参阅：节点错误处理策略

典型用例

HTTP 请求节点充当桥梁，促进您的系统与其他外部服务或应用程序之间的通信。想象一下，您的工作流需要从外部源获取信息或发送信息出去；这时 HTTP 请求节点就派上用场了。

• 调用第三方 API 收集数据：例如，通过链接检索 YouTube 视频的标题、订阅者数量和观看次数。
• 集成内部企业系统：例如，使用企业系统的 API 接口定期发送收集到的信息。

实际案例场景

客户支持系统中自动化工单分类工作流的设计步骤：

• 1. 开始节点：
  • 收集客户提交的信息，包括账户详情、问题描述、优先级和问题类型。
• 2. HTTP 请求节点（创建工单）：
  • 请求方法：POST
  • URL：工单创建的 API 调用点。
  • Body：包含客户信息、问题详情、优先级和问题类型。
  • 输出：获取创建的工单 ID。
• 3. 自然语义分类器（问题分类）：
  • 对用户查询进行分类，例如技术问题和账单问题。
• 4. HTTP 请求节点（分类至技术支持部门）：
  • 请求方法：POST
  • URL：技术支持团队内部系统的 API 调用点。
  • Body：包含工单 ID 和问题详情。
• 5. HTTP 请求节点（分类至账单支持部门）：
  • 请求方法：POST
  • URL：账单支持团队内部系统的 API 调用点。
  • Body：包含工单 ID 和问题详情。
• 6. 结束节点：结束工作流。

通过此工作流，客户填写所需信息后，可以自动创建工单，然后自动分类。

注意事项

• 法律风险：遵守机器人排除协议，避免非法网络抓取。
• 速率限制：第三方 API 通常有 QPS（每秒查询次数）限制，以确保所有用户公平访问。
• 成本控制：有些 API 根据调用次数收费；请注意定价。

常见问题解答

Q1: 我该如何处理超时问题？

调整超时设置参数，默认值为30秒，可以根据需要进行修改。

Q2: 我该如何找到合适的API？

许多网站提供各种API接口，例如rapidapi.com。