TaskList-查看任务列表
更新时间：2025-12-26
API访问域名
| 请求方式 | GET |
|---|---|
| base url | https://keyue.cloud.baidu.com |
| 后缀接口 | /open/v1/api/v2/task/openList |
| Authentication | token为API Key |
说明
无
请求参数
Header参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | 内容类型 | 固定值：application/json |
| token | string | 是 | API KEY | 机器人API KEY。 详细获取方式参考：准备工作 |
| uid | string | 是 | 用户ID | 详细获取方式参考：准备工作 |
| username | string | 是 | 用户名 | 详细获取方式参考：准备工作 |
Parameter参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| pn | integer | 否 | 页数 | 可以根据这个字段分页查询task，默认是1 |
| ps | integer | 否 | 每页查询数据条数 | 可以根据这个字段分页查询task，默认是20 |
| queryLevel | int | 是 | 查询级别 | 查询级别 0:查询指定任务的详情，需要配合taskUrl使用 1:查询指定agent的任务详情 2:查询指定租户的任务详情 |
| taskUrl | string | 否 | 任务URL |
Body参数
无
响应参数
| 名称 | 类型 | 必填 | 中文名 | 说明 |
|---|---|---|---|---|
| time | integer | 是 | 时间 | 1722239381781 |
| data | object | 是 | 数据 | 数据对象，详见data子数据 |
| code | integer | 是 | 状态码 | 200 |
| msg | string | 是 | 状态信息 | OK |
data子数据
| 名称 | 类型 | 必填 | 中文名 | 说明 |
|---|---|---|---|---|
| total | integer | 是 | 列表agent总数 | 2 |
| pn | integer | 是 | 页数 | 1 |
| ps | integer | 是 | 每页包含agent数量 | 20 |
| queryLevel | int | 是 | 查询级别 | 查询级别 0:查询指定任务的详情，需要配合taskUrl使用 1:查询指定agent的任务详情 2:查询指定租户的任务详情 |
| taskList | array | 否 | 任务列表 | 详见taskList子数据 |
taskList子数据
| 名称 | 类型 | 必填 | 中文名 | 说明 |
|---|---|---|---|---|
| id | string | 是 | 任务ID | |
| agentName | string | 是 | agent名称 | |
| createTime | string | 是 | 创建时间 | 2024-12-25 15:59:31 |
| moudel | string | 是 | 模块名称 | |
| taskType | string | 是 | 任务类型 | |
| status | integer | 是 | 任务状态 | 任务状态：0-处理中；1-成功；2-失败 |
| msg | string | 否 | 错误消息 | |
| downloadUrl | string | 否 | 文件url |
请求示例
Bash
1curl --location 'https://keyue.cloud.baidu.com/open/v1/api/v2/task/openList?pn=1&ps=10&taskUrl=%2Fapi%2Fv2%2Ffaq%2Fbatch%2Fimport&queryLevel=0' \
2--header 'token: xxxx' \
3--header 'uid: xxxx' \
4--header 'username: xxxx'响应示例
1{
2 "time": 1735281384085,
3 "data": {
4 "total": 4,
5 "pn": 1,
6 "ps": 10,
7 "queryLevel": 0,
8 "taskList": [
9 {
10 "id": "cd8851b0-57e9-4ef8-ac24-39d44efc8ace",
11 "agentName": "hui-888",
12 "createdTime": "2024-12-26 15:46:33",
13 "module": "faq",
14 "taskType": "import",
15 "status": 2,
16 "msg": "问答上传的excel工作簿（sheet）缺失_##_400",
17 "downloadUrl": "https://keyue.cloud.baidu.com/api/v2/task/download?id=Ym9zX2E5MzMyY2ZmLWQ2ZTgtNDE5MC1hNGZiLTM4M2FjOWVkNDdiOQ==&taskId=cd8851b0-57e9-4ef8-ac24-39d44efc8ace"
18 },
19 {
20 "id": "3bcd90ad-36b1-462f-b854-4ba873d0866d",
21 "agentName": "hui-888",
22 "createdTime": "2024-12-05 11:10:51",
23 "module": "faq",
24 "taskType": "import",
25 "status": 1,
26 "msg": "ok_##_200_##_通用答案：成功2条，失败0条，忽略0条。 相似问题：成功4条，失败0条，忽略0条。 模板：成功1条，失败1条，忽略0条。 条件答案：成功1条，失败0条，忽略1条。",
27 "downloadUrl": "https://keyue.cloud.baidu.com/api/v2/task/download?id=Ym9zXzY5NDQ4OTRlLWY4NDEtNDY0NC05ZGE5LTdkZTUwYmUxM2ZkMg==&taskId=3bcd90ad-36b1-462f-b854-4ba873d0866d"
28 }
29 ]
30 },
31 "code": 200,
32 "msg": "OK"
33}1{
2 "msg": "API Key 为空，请填写机器人对应的API Key",
3 "tip": "",
4 "code": 4008651,
5 "requestId": "899e6ee575b5478c9066496ac2dbfcc9"
6}