Berdasarkan task yang telah dibuat, status task dapat dikueri menggunakan taskId.
Status task terbagi menjadi lima jenis: ["submitted", "TERMINATED", "RUNNING", "FINISHED", "EXITED"].
Metode Permintaan (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'Parameter Permintaan (parameter URL)
nama | lokasi parameter | tipe | wajib diisi | deskripsi |
taskId | url | String | ya | ID Tugas |
Parameter respons
Nama | tipe | nilai contoh | deskripsi |
data.taskName | String | media_task_1 | Nama Tugas |
data.taskId | String | 30BA59AE-2459-4E1A-8154-A844BD0A2FC0 | ID task |
data.status | String | ["SUBMITED","TERMINATED","RUNNING","FINISHED","EXITED"] | Status task |
data.traceInfo | String | "Exception: oss Download timeout" | Jika task mengalami anomali, informasi pengecualian akan disertakan. |
Kode Error
Kode Error (errorCode) | deskripsi |
ERR_INTERNAL_SERVER_ERROR | Penanganan Error |
ERR_INVALID_PARAMETER | taskId tidak ditemukan |
Penanganan Timeout
Timeout | Kebijakan Timeout |
3s | Saat terjadi timeout, hentikan permintaan sebelumnya dan lakukan inisiasi ulang API dengan parameter permintaan yang sama di sisi server Anda. |
return
{
"success": true,
"errorCode": null,
"errorMsg": null,
"traceId": "30BA59AE-2459-4E1A-8154-A844BD0A2FC0",
"data": {
"taskName": "txxxn",
"taskId": "fbb8acbe-d680-4c9f-8f3d-3e8733e02199",
"status": "FINISHED",
"traceInfo": ""
}
}