Studio Web 用户指南

适用平台：

上次更新日期 2025年10月27日

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 的有效负载，允许您使用表达式编辑器引用上一步输出中的数据。
Debug the workflow to execute the activity and generate output fields for later use.

HTTP 活动示例

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

Open the Debug configuration window, then paste and save the following JSON syntax in the Project arguments section:

{
  "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 的格式：
Debug the workflow to execute the activity.
请查看输出面板，以查看 HTTP 响应。