媒資任務狀態查詢介面 - SuperApp

基於已建立任務, 通過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": ""
    }
}