HTTP

HTTP 请求活动使您能够在工作流中执行基于 JSON 的 API 请求。您可以使用通用 HTTP 连接器或任何受支持的 Integration Service 连接器进行身份验证，但您也可以选择在没有连接的情况下使用活动，并直接在请求中提供身份验证详细信息。

该活动提供对请求配置的完全控制，允许动态定义方法、URL、标头和正文内容。执行后，响应数据可在后续工作流步骤中引用，从而成为与外部 API 交互的关键组件。

备注：

您可以通过将所需的 cURL 粘贴到聊天中，利用 Autopilot 为您添加 HTTP 请求。

使用 HTTP 活动

要将HTTP 请求活动添加到工作流中，请执行以下操作：

1. 在 API 工作流设计器画布上，选择加号 (+) 图标。系统将显示“添加活动”菜单。
2. 选择“HTTP” 。
3. 在“属性”面板中，配置以下字段：
   • 要使用的身份验证类型，可以是“手动身份验证”或“基于连接器的身份验证” 。
   • “连接器” — 如果选择了“基于连接器的身份验证”，请选择要使用的连接器。
   • 连接— 在 Integration Service 中建立的连接。选择现有连接，单击“ + 连接”以添加新连接，或单击“打开连接”以管理连接。
   • “方法” — 请求的 HTTP 方法，包括 GET、POST、PATCH、DELETE、PUT、OPTIONS 或 HEAD。
   • 请求 URL — 请求的 API 端点。您可以使用表达式编辑器动态构建 URL。例如，附加从工作流的上一个步骤中检索到的 ID。如果设置了基本 URL，请输入相对路径。要覆盖它，请使用具有相同基本域的绝对 URL。
   • “标头” — 以键值对形式表示的请求标头。标头使用 JSON 对象格式，并且可以使用表达式编辑器动态生成。例如：

     {
       "Content-Type": "application/json",
       "Accept": "application/json",
       "Authorization": "Bearer jfio**********"
     }
     

   • 查询参数— 查询参数。使用“字典编辑器”添加新参数。
     • 示例：query value "select * from Vendor"（适用于 QuickBooks Online）。
   • 正文— 适用于所有 HTTP 方法，但 GET、OPTIONS 和 HEAD 除外。支持基于 JSON 的有效负载，允许您使用表达式编辑器引用上一步输出中的数据。
4. 调试工作流以执行活动并生成输出字段以供以后使用。

HTTP 活动示例

以下示例向 HTTPBin 发出 POST 请求，该请求将返回请求数据以进行验证。请求包含动态路径变量、标头和结构化请求正文。

打开“调试配置”窗口，然后在“项目参数”部分粘贴并保存以下 JSON 语法：

{
  "id": 12345,
  "name": "John Doe",
  "isActive": true,
  "balance": 2500.75,
  "createdAt": "2025-03-25T12:00:00Z",
  "tags": [
    "premium",
    "verified",
    "active"
  ],
  "address": {
    "street": "123 Main St",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "coordinates": {
      "latitude": 40.7128,
      "longitude": -74.006
    }
  },
  "transactions": [
    {
      "transactionId": "txn_001",
      "amount": 150.5,
      "currency": "USD",
      "timestamp": "2025-03-24T10:30:00Z",
    },
    {
      "transactionId": "txn_002",
      "amount": -75.25,
      "currency": "USD",
      "timestamp": "2025-03-23T08:15:00Z"
    }
  ]
}

1. 在 API 工作流设计器画布上，添加“脚本”活动，以输出“持有者令牌”值：

   1. 打开“表达式编辑器”并返回一个 JSON，其属性名为“bearer_token” ：

      return {
          "bearer_token": "123321123321"
      }
      

   2. 保存。

2. 将HTTP活动添加到设计器画布中。

3. 按如下方式配置HTTP活动：

   • 方法— POST
   • 请求 URL — 使用“表达式编辑器”，使用ID路径变量构建 URL 字符串：

     "https://www.httpbin.org/anything/" + ($workflow.input.id)
     

   • “标头” — 通过指定简单的键值 JSON 来添加标头。您还将模拟添加持有者令牌作为“授权”标头的流程：

     {
         "Accept": "application/json",
         "Content-Type": "application/json",
         "Authorization": ("Bearer " + $context.outputs.Javascript_3.bearer_token)
     }
     

   • 请求正文— 使用表达式编辑器，通过引用运行配置 JSON，动态构建请求正文。目标是将包含在对象中的事务数组作为请求有效负载传递：

     {
         "transactions": $workflow.input.transactions
     }
     

   请注意， “表达式输出”面板会根据活动测试输入数据显示最终 JSON 的格式：

   

4. 调试工作流以执行活动。

5. 请查看输出面板，以查看 HTTP 响应。