查询实例列表
POST
/approval/v4/instances/query
approval_code 和 group_external_id 查询结果取并集，instance_code 和 instance_external_id 查询结果取并集，其他查询条件都对应取交集
查询时间跨度不得大于30天，开始和结束时间必须都设置，或者都不设置
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 1390001 | param is invalid | 参数错误 |
| 400 | 1390002 | approval code not found | 检查审批定义code是否正确 |
| 400 | 1390003 | instance code not found | 检查审批实例code是否正确 |
| 400 | 1395001 | There have been some errors. Please try again later | 服务出现错误，请稍候再试 |
请求参数
Query 参数
Body 参数application/json
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/approval/v4/instances/query?page_size=&page_token=nF1ZXJ5VGhlbkZldGNoCgAAAAAA6PZwFmUzSldvTC1yU&user_id_type=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"user_id": "lwiu098wj",
"approval_code": "EB828003-9FFE-4B3F-AA50-2E199E2ED942",
"instance_code": "EB828003-9FFE-4B3F-AA50-2E199E2ED943",
"instance_external_id": "EB828003-9FFE-4B3F-AA50-2E199E2ED976",
"group_external_id": "1234567",
"instance_title": "test",
"instance_status": "PENDING",
"instance_start_time_from": "1547654251506",
"instance_start_time_to": "1547654251506",
"locale": "zh-CN"
}'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"count": 10,
"instance_list": [
{
"approval": {
"code": "EB828003-9FFE-4B3F-AA50-2E199E2ED943",
"name": "approval",
"is_external": true,
"external": {
"batch_cc_read": false
},
"approval_id": "7090754740375519252",
"icon": "https://lf3-ea.bytetos.com/obj/goofy/ee/approval/approval-admin/image/iconLib/v3/person.png"
},
"group": {
"external_id": "0004",
"name": "groupA"
},
"instance": {
"code": "EB828003-9FFE-4B3F-AA50-2E199E2ED943",
"external_id": "0004_3ED52DC1-AA6C",
"user_id": "lwiu098wj",
"start_time": "1547654251506",
"end_time": "1547654251506",
"status": "pending",
"title": "test",
"extra": "{}",
"serial_id": "201902020001",
"link": {
"pc_link": "https://www.baidu.com/",
"mobile_link": "https://www.baidu.com/"
}
}
}
],
"page_token": "nF1ZXJ5VGhlbkZldGNoCgAAAAAA6PZwFmUzSldvTC1yU",
"has_more": false
}
}
扫码加入交流群修改于 2025-10-21 07:16:40