查询用户的任务列表
GET
https://open.feishu.cn/open-apis/approval/v4/tasks/query
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 1390001 | param is invalid | 参数错误 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.feishu.cn/open-apis/approval/v4/tasks/query?page_size=&page_token=&user_id=&topic=&user_id_type=' \
--header 'Authorization;'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"tasks": [
{
"topic": "1",
"user_id": "example_user_id",
"title": "任务题目示例",
"urls": {
"helpdesk": "https://blabla",
"mobile": "https://blabla",
"pc": "https://blabla"
},
"process_external_id": "example_instance_id",
"task_external_id": "example_task_id",
"status": "Todo",
"process_status": "Running",
"definition_code": "000000-00000000000000-0example",
"initiators": [
"starter"
],
"initiator_names": [
"发起人姓名"
],
"task_id": "1212564555454",
"process_id": "1214564545474",
"process_code": "123e4567-e89b-12d3-a456-426655440000",
"definition_group_id": "1212564555454",
"definition_group_name": "流程定义名称",
"definition_id": "1212564555454",
"definition_name": "流程定义组名称"
}
],
"page_token": "example_page_token",
"has_more": true,
"count": {
"total": 123,
"has_more": false
}
}
}请求参数
Query 参数
page_size
string
可选
page_token
string
必需
user_id
string
必需
topic
string
必需
2：已办审批
3：已发起审批
17：未读知会
18：已读知会
user_id_type
string
可选
union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？
user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？
默认值：open_id
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
返回响应
扫码加入交流群修改于 2023-02-02 04:08:25