文档中心

增长营销平台

任务管理

查询任务状态

调用本接口查询指定任务的详细信息，包括父任务状态与子任务状态等。

基本信息

接口 path：/gmp/openapi/v1/task/task_list
请求方式：POST、application/json

请求参数

参数	类型	是否必填	描述
task_list	list	是	要查询的任务列表
task_id	string	是	任务 ID
task_type	string	是	任务类型。 task：消息触达 canvas：流程画布
sub_task	list	是	对应的子任务列表
sub_task_id	string	是	对应的子任务id

请求示例

{
    "task_list": [
        {
            "task_id": "10018",
            "task_type": "task",
            "sub_task": []
        },
        {
            "task_id": "10014",
            "task_type": "task",
            "sub_task": [
                {
                    "sub_task_id": "10082"
                }
            ]
        }
    ]
}

响应参数

参数	类型	描述
code	int32	错误码（），正常返回 0
data	object	查询的任务列表
msg	string	结果信息
msg.task_id	string	任务 ID
msg.task_type	string	任务类型
msg.status	int64	父任务状态。 1：任务处于草稿状态 2：任务等待审批 3：任务审批已被通过 4：任务处于暂停状态 5：任务已结束 6：任务已取消 7：任务处于异常状态 8：任务审批被拒绝 9：任务已被删除 10：任务失败 11：任务为模板状态
msg.sub_task	list	对应的子任务列表
msg.sub_task.sub_task_id	string	对应的子任务 ID
msg.sub_task.status	int64	调度子任务状态。 1：任务处于等待执行状态 2：任务正在运行当中 3：任务已经结束 4：任务已被取消 5：任务执行失败 6：任务失败且不可重试 7：任务处于暂停状态

响应示例

{
    "code": 0,
    "data": [
        {
            "task_type": "task",
            "task_id": "10018",
            "status": 5，
            "sub_task": [
                {
                    "sub_task_id": "10084",
                    "status": 3
                }
            ]
        },
        {
            "task_type": "task",
            "task_id": "10014",
            "status": 5，
            "sub_task": [
                {
                    "sub_task_id": "10082",
                    "status": 3
                }
            ]
        }
    ],
    "msg": "成功",
    "extra_msg": "",
    "log_id": "02169449986754000000000000000000000ffff0a2a0234869491"
}

最近更新时间：2026.08.25 14:20:43

这个页面对您有帮助吗？

有用

无用