查询用户的任务列表

GET

/approval/v4/tasks/query

根据用户和任务分组查询任务列表。

错误码

HTTP状态码	错误码	描述	排查建议
400	1390001	param is invalid	参数错误

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/approval/v4/tasks/query?page_size=&page_token=&user_id=&topic=&user_id_type=' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "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
        }
    }
}

修改于 2025-10-21 07:16:58

查询任务列表

查询审批 ID（专用）

查询用户的任务列表

错误码#

请求参数

返回响应

错误码