全部产品
Search
文档中心

SuperApp:媒资任务状态查询接口

更新时间:Apr 22, 2026

基于已创建任务, 通过taskid对任务状态进行查询

说明

任务状态分为5种:["SUBMITED","TERMINATED","RUNNING","FINISHED","EXITED"]

请求方式(curl)

  curl --location 'https://example.com/media-intelligence/openapi/v1/workflow-tasks/getTaskStatus?taskId=xxx' \
--header 'X-Request-Id: db160925-0b58-4609-bc6e-08cdf12bf2e6' \
--header 'X-Access-Key: 5017114*******' \
--header 'X-Request-Sign: 7894db2a4*******c23976d6d42c93e' \
--header 'X-Request-Timestamp: 1736162679922'

请求参数(url param)

名称

参数位置

类型

是否必填

描述

taskId

url

String

任务ID

返回参数

名称

类型

示例值

描述

data.taskName

String

media_task_1

任务名称

data.taskId

String

10f5ce42-0a91-49d5-979d-8a9e8b326e5a6666

任务id

data.status

String

["SUBMITED","TERMINATED","RUNNING","FINISHED","EXITED"]

任务状态

data.traceInfo

String

"Exception: oss Download timeout"

如任务异常,会携带异常信息


错误码

错误码(errorCode)

说明

ERR_INTERNAL_SERVER_ERROR

处理错误

ERR_INVALID_PARAMETER

taskid 缺失

超时处理

超时时间

超时策略

3s

When a timeout occurs, terminate the previous request and reinitiate the API with the same request parameters on your server side.

返回

{
    "success": true,
    "errorCode": null,
    "errorMsg": null,
    "traceId": "30BA59AE-2459-4E1A-8154-A844BD0A2FC0",
    "data": {
        "taskName": "txxxn",
        "taskId": "fbb8acbe-d680-4c9f-8f3d-3e8733e02199",
        "status": "FINISHED",
        "traceInfo": ""
    }
}