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

# 更新任务参数

> **所需套餐：** 旗舰+、企业版、团队版

## 端点

```
POST https://openapi.bazhuayu.com/task/updateTaskParameters
```

## 描述

通过该接口，用户可以一次性更新多行输入框中的可循环参数（如多行文本、多行URLs），以及单个文本、数字等非循环参数。

## 请求头

| 参数              | 类型     | 必填 | 说明               |
| --------------- | ------ | -- | ---------------- |
| `Authorization` | String | 是  | 身份令牌             |
| `Content-Type`  | String | 是  | application/json |

**请求头示例**

```json theme={null}
{
  "Authorization": "Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6ImdXS3hWc0F4SHhaMDlDcWh6NkNJb3ciLCJ0eXAiOiJhdCtqd3QifQ.eyJuYmYiOjE2MzY0NjIyNzAsImV4cCI6MTYzNjU0ODY2OSwiaXNzIjoiaHR0cDovL3Rlc3QuaWRlbnRpdHkuYmF6aHVheXUuY29tIiwiY2xpZW50X2lkIjoiT2N0b3B1cyIsInN1YiI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImF1dGhfdGltZSI6MTYzNjQ2MjI3MCwiaWRwIjoibG9jYWwiLCJodHRwOi8vc2NoZW1hcy54bWxzb2FwLm9yZy93cy8yMDA1LzA1L2lkZW50aXR5L2NsYWltcy9uYW1laWRlbnRpZmllciI6IjllOGJiM2VhLWUwMWQtNGFlZC05ODM3LTVhMWUyODg0NWI5ZSIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL25hbWUiOiJ0ZXN0d2VuIiwicHJlZmVycmVkX3VzZXJuYW1lIjoidGVzdHdlbiIsInVuaXF1ZV9uYW1lIjoidGVzdHdlbiIsInJlZ2lzdGVyX2RhdGUiOiIxMS8wNC8yMDE2IDA4OjM4OjE2ICswODowMCIsImxhc3RfbG9naW5fZGF0ZSI6IjA0LzIyLzIwMTkgMDk6MDE6MDIgKzA4OjAwIiwibGFzdF9wYXNzd29yZF9jaGFuZ2VkX2RhdGUiOiIwMS8yMy8yMDE5IDA4OjMwOjMxICswODowMCIsImh0dHA6Ly9zY2hlbWFzLnhtbHNvYXAub3JnL3dzLzIwMDUvMDUvaWRlbnRpdHkvY2xhaW1zL2VtYWlsYWRkcmVzcyI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbCI6IndlbmRpQHNraWVlci5jb20iLCJlbWFpbF92ZXJpZmllZCI6dHJ1ZSwic2NvcGUiOlsiZW1haWwiLCJvcGVuaWQiLCJyb2xlcyIsIm9mZmxpbmVfYWNjZXNzIl0sImFtciI6WyJwd2QiXX0.ARhbBfzI1xS6yo-Ue1CFHzMaUIfzw4gJlubNBOkUT4SSTlhuS4bVQ4t4UHuYGbE9VX6XgNVgkcDnx6XapqcPohSy7vPv9TIAsjtbrQSA3mj13SnVVAPWwfAVJ-I7g9HDnyPEEOVSvmZUJhiz-irH5L0ojbnt3ck2rQ9tIFuSd7j2eh5BS4ItjNoHY00rh_QPZltk66a9q-fNE33GrxOaXUdHH47WMlsENnh1gybB7QtGtd6bZ982Qa9JljpFnZWSdEf4VfkN4JmhkUTTC908DqS3stT-LD-9tpztFwB54sd0D4CyOBnESkKrUwjxchYYZo4l1O7auiZVGV48YhZYMw",
  "Content-Type": "application/json"
}
```

## 请求体

| 参数          | 类型        | 必填 | 说明                                                        |
| ----------- | --------- | -- | --------------------------------------------------------- |
| `taskId`    | String    | 是  | 任务 Id                                                     |
| `actions`   | Object\[] | 否  | 需要更新的步骤参数（`actionType`、`actionId`、`properties` 等），参考：步骤属性 |
| `loopItems` | Object\[] | 否  | 需要更新的循环项参数（`actionId`、`loopType`、`loopItems`、`isAppend`）  |

**请求体示例**

```json theme={null}
{
  "taskId": "a3b9bdf7-9aaa-22f6-9ccf-b32790f6df8f",
  "actions": [
    {
      "actionType": "EnterTextAction",
      "actionId": "ce1wg4nytr",
      "properties": [
        {
          "name": "TextToSet",
          "value": "4k显示器123"
        }
      ]
    }
  ],
  "loopItems": [
    {
      "actionId": "loop1",
      "loopType": "URLList",
      "loopItems": [
        "http://www.example1.com",
        "http://www.example2.com"
      ],
      "isAppend": false
    }
  ]
}
```

## 响应

| 参数                  | 类型        | 必填 | 说明       |
| ------------------- | --------- | -- | -------- |
| `requestId`         | String    | 是  | 请求Id     |
| `data`              | Object    | 是  | 响应数据     |
| `taskId`            | String    | 是  | 任务Id     |
| `updatedParameters` | Object    | 是  | 更新的参数信息  |
| `actions`           | Object\[] | 是  | 更新的动作参数  |
| `loopItems`         | Object\[] | 是  | 更新的循环项参数 |

**成功示例**

```json theme={null}
{
  "data": {
    "taskId": "a3b9bdf7-9aaa-22f6-9ccf-b32790f6df8f",
    "updatedParameters": {
      "actions": [
        {
          "actionId": "ce1wg4nytr",
          "actionType": "EnterTextAction",
          "properties": [
            {
              "name": "TextToSet",
              "value": "4k显示器123"
            }
          ]
        }
      ],
      "loopItems": [
        {
          "actionId": "loop1",
          "loopType": "URLList",
          "loopItems": [
            "http://www.example1.com",
            "http://www.example2.com"
          ]
        }
      ]
    }
  },
  "requestId": "0HMCVDHG1V3E6:00000002"
}
```

## 错误响应

| 参数          | 类型     | 必填 | 说明         |
| ----------- | ------ | -- | ---------- |
| `requestId` | String | 是  | 请求Id       |
| `error`     | Object | 是  | 错误信息，参考错误码 |
| `code`      | String | 是  | 错误码        |
| `message`   | String | 是  | 错误详情       |

**错误示例**

```json theme={null}
{
  "error": {
    "code": "RequestModelNull",
    "message": "请求参数不能为空"
  },
  "requestId": "0HMCVDHG1V3E6:00000002"
}
```

<ParamField header="Authorization" type="string" required hidden />

<ParamField header="Content-Type" type="string" default="application/json" required hidden />

<ParamField body="taskId" type="string" required hidden />