Studio Web 用户指南

适用平台：

上次更新日期 2025年9月22日

HTTP

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

已知限制

不支持通过 Integration Service 配置的连接。要利用来自连接器的现有身份验证或连接，请使用“连接器”活动，并从该连接器中选择“HTTP 请求”活动。
仅支持基于 JSON 的请求和响应。确保您的请求包含标头，例如Content-Type: application/json和Accept: application/json 。

使用 HTTP 活动

要将HTTP活动添加到工作流中：

在 API 工作流设计器画布上，选择加号 (+) 图标。系统将显示“添加活动”菜单。
选择“HTTP” 。
在“属性”面板中，配置以下字段：
- “方法” — 指定请求的 HTTP 方法，例如 GET、POST、PATCH、DELETE 或 PUT。
- 请求 URL — 定义请求的 API 端点。您可以使用表达式编辑器动态构建 URL。例如，附加从工作流的上一个步骤中检索到的 ID。
- 标头 —将请求标头定义为键值对。标头使用 JSON 对象格式，并且可以使用表达式编辑器动态生成。例如：
```
{
  "Content-Type": "application/json",
  "Accept": "application/json",
  "Authorization": "Bearer jfio**********"
}{
  "Content-Type": "application/json",
  "Accept": "application/json",
  "Authorization": "Bearer jfio**********"
}
```
- “请求正文” — 适用于所有 HTTP 方法，但“GET”和“HEAD”除外。支持基于 JSON 的有效负载，允许您使用表达式编辑器引用上一步输出中的数据。
测试工作流以执行活动并生成输出字段以供以后使用。

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"
    }
  ]
}{
  "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"
    }
  ]
}

在 API 工作流设计器画布上，添加“脚本”活动，以输出“持有者令牌”值：
1. 打开“表达式编辑器”并返回一个 JSON，其属性名为“bearer_token” ：
```
return {
    "bearer_token": "123321123321"
}return {
    "bearer_token": "123321123321"
}
```
2. 保存。
将HTTP活动添加到设计器画布中。
按如下方式配置HTTP活动：
- 方法— POST
- 请求 URL — 使用“表达式编辑器”，使用ID路径变量构建 URL 字符串：
```
"https://www.httpbin.org/anything/" + ($workflow.input.id | tostring)"https://www.httpbin.org/anything/" + ($workflow.input.id | tostring)
```
- “标头” — 通过指定简单的键值 JSON 来添加标头。您还将模拟添加持有者令牌作为“授权”标头的流程：
```
{
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": ("Bearer " + $context.outputs.Javascript_3.bearer_token)
}{
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Authorization": ("Bearer " + $context.outputs.Javascript_3.bearer_token)
}
```
- 请求正文— 使用表达式编辑器，通过引用运行配置 JSON，动态构建请求正文。目标是将包含在对象中的事务数组作为请求有效负载传递：
```
{
    "transactions": $workflow.input.transactions
}{
    "transactions": $workflow.input.transactions
}
```
请注意， “表达式输出”面板会根据活动测试输入数据显示最终 JSON 的格式：
测试工作流以执行活动。
请查看输出面板，以查看 HTTP 响应。