メディアタスクのステータスクエリインターフェース - SuperApp

作成されたタスクに基づき、taskId を使用してタスクのステータスをクエリします。

説明

タスクステータスは、["submitted"、"TERMINATED"、"RUNNING"、"FINISHED"、"EXITED"] の 5 種類に分けられます。

リクエストメソッド (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 パラメーター)

名前	パラメーターの場所	型	必須	説明
taskId	url	String	はい	タスク ID

戻り値パラメーター

名前	型	値の例	説明
data.taskName	String	media_task_1	タスク名
data.taskId	String	30BA59AE-2459-4E1A-8154-A844BD0A2FC0	タスク 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	タイムアウトが発生した場合、前のリクエストを終了し、サーバー側で同じリクエストパラメーターを使用して API を再開してください。

戻り値

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