TaskList-查看任务列表
更新时间：2025-01-24
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-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 |
请求示例
curl --location 'https://keyue.cloud.baidu.com/open/v1/api/v2/task/openList?pn=1&ps=10&taskUrl=%2Fapi%2Fv2%2Ffaq%2Fbatch%2Fimport&queryLevel=0' \
--header 'token: e8f9bd88-423f-4830-9f71-567b4c3cbb2b' \
--header 'uid: cf7d9692703d45d1b5517a30ab3efa53' \
--header 'username: pnstest5'响应示例
{
"time": 1735281384085,
"data": {
"total": 4,
"pn": 1,
"ps": 10,
"queryLevel": 0,
"taskList": [
{
"id": "cd8851b0-57e9-4ef8-ac24-39d44efc8ace",
"agentName": "hui-888",
"createdTime": "2024-12-26 15:46:33",
"module": "faq",
"taskType": "import",
"status": 2,
"msg": "问答上传的excel工作簿（sheet）缺失_##_400",
"downloadUrl": "https://keyue.cloud.baidu.com/api/v2/task/download?id=Ym9zX2E5MzMyY2ZmLWQ2ZTgtNDE5MC1hNGZiLTM4M2FjOWVkNDdiOQ==&taskId=cd8851b0-57e9-4ef8-ac24-39d44efc8ace"
},
{
"id": "3bcd90ad-36b1-462f-b854-4ba873d0866d",
"agentName": "hui-888",
"createdTime": "2024-12-05 11:10:51",
"module": "faq",
"taskType": "import",
"status": 1,
"msg": "ok_##_200_##_通用答案：成功2条，失败0条，忽略0条。 相似问题：成功4条，失败0条，忽略0条。 模板：成功1条，失败1条，忽略0条。 条件答案：成功1条，失败0条，忽略1条。",
"downloadUrl": "https://keyue.cloud.baidu.com/api/v2/task/download?id=Ym9zXzY5NDQ4OTRlLWY4NDEtNDY0NC05ZGE5LTdkZTUwYmUxM2ZkMg==&taskId=3bcd90ad-36b1-462f-b854-4ba873d0866d"
}
]
},
"code": 200,
"msg": "OK"
}{
"msg": "API Key 为空，请填写AI客服对应的API Key",
"tip": "",
"code": 4008651,
"requestId": "899e6ee575b5478c9066496ac2dbfcc9"
}