# 查询任务关联机器人变量列表接口

用于查询指定任务所使用的机器人下，关联的全部变量列表

<span style="display:inline-block;background:#e6f8ea;color:#22a366;border-radius:6px;padding:2px 8px;font-weight:bold;font-family:monospace;margin-right:8px;">GET</span>
`https://dashboard.avavox.com/open/api/task/{taskId}/robot-variables`

## 请求头

<span style="font-family:monospace; color:#3451b2; ">Authorization</span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

- 填写格式：`Authorization: Bearer <App Key>`
- `<App Key>` 为控制台「App Key 管理」页面生成的 Key。
- 获取方式详见：[《App Key 创建与管理》](https://avavox.com/docs/developer/app-key.html)。


## Path 参数
<span style="font-family:monospace; color:#3451b2; ">taskId </span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

需要查询的任务ID


## 响应数据

<span style="font-family:monospace; color:#3451b2; ">code</span> <code style="background:#f0f0f0; ">int</code>

状态码，200 为成功，其他状态均为失败。

---

<span style="font-family:monospace; color:#3451b2; ">success</span> <code style="background:#f0f0f0; color: #333; ">boolean</code>

是否成功，`true` 表示成功，`false` 表示失败。

---

<span style="font-family:monospace; color:#3451b2; ">message</span> <code style="background:#f0f0f0;">string</code>

描述信息

---

<span style="font-family:monospace; color:#3451b2; ">data</span> <code style="background:#f0f0f0;">object</code>

任务详情数据，结构如下：

<details>
<summary>点击展开字段说明</summary>

<div style="margin: 16px 0; padding: 16px;  border-left: 1px solid #f0f0f0; border-radius: 6px;">

<span style="font-family:monospace; color:#3451b2; ">robotId</span> <code style="background:#f0f0f0; ">string</code>

机器人 ID。

---

<span style="font-family:monospace; color:#3451b2; ">robotName</span> <code style="background:#f0f0f0; ">string</code>

机器人名称

---


<span style="font-family:monospace; color:#3451b2; ">variables</span> <code style="background:#f0f0f0; ">array</code>

变量列表

<details>
<summary>点击展开字段说明</summary>

<span style="font-family:monospace; color:#3451b2; ">name</span> <code style="background:#f0f0f0; ">string</code>

变量名称

---

<span style="font-family:monospace; color:#3451b2; ">key</span> <code style="background:#f0f0f0; ">string</code>

变量key

---

<span style="font-family:monospace; color:#3451b2; ">description</span> <code style="background:#f0f0f0; ">string</code>

变量描述信息

---

<span style="font-family:monospace; color:#3451b2; ">defaultValue</span> <code style="background:#f0f0f0; ">string</code>

变量默认值

---

<span style="font-family:monospace; color:#3451b2; ">required</span> <code style="background:#f0f0f0; ">boolean</code>

变量是否必填，`true`-必填，`false`-非必填

---

<span style="font-family:monospace; color:#3451b2; ">category</span> <code style="background:#f0f0f0; ">string</code>

变量类型

- `custom`：自定义变量
- `system`：系统变量



</details>

---


</div>
</details>


## 请求示例

```shell
curl --location 'https://dashboard.avavox.com/open/api/task/123/robot-variables' \
--header 'Authorization: Bearer $Key' \
--header 'Content-Type: application/json'

```



## 响应示例

```json
{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": {
    "robotId": "机器人ID",
    "robotName": "机器人名称",
    "variables": [
      {
        "name": "变量名称",
        "key": "变量key",
        "description": "变量描述信息",
        "defaultValue": "变量默认值",
        "required": true,
        "category": "custom"
      }
    ]
  }
}
```