取得任務狀態
更新時間 2025-04-16 10:39:51
最近更新時間: 2025-04-16 10:39:51
分享文章
通過本接口向云點播查詢已經提交的轉碼任務狀態。
接口功能介紹
用戶可通過本接口向云點播查詢已經提交的轉碼任務狀態。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
POST /task/status
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| taskId | 是 | String | 由提交任務返回的任務id | 0001#1a619cdd3f19406794f9663ee246cb7e |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼 | 0 | |
| message | 是 | String | 錯誤文本信息，創建成功時，為空字符串。 | "" | |
| data | 是 | Object | 返回數據 | data |
表 data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| taskId | 是 | String | 任務ID | 0001#1a619cdd3f19406794f9663ee246cb7e | |
| status | 是 | String | 狀態，WORKING/DONE/WARNING/FAIL。 | WORKING | |
| progress | 是 | Float | 0 ~ 1 之間的浮點數，代表當前任務執行進度。 | 0.3024 |
請求示例
請求體body
{
"taskId": "0001#1a619cdd3f19406794f9663ee246cb7e"
}
響應示例
{
"code": 0,
"message": "",
"data": {
"progress": 0.3024,
"taskId": "0001#1a619cdd3f19406794f9663ee246cb7e",
"status": "WORKING"
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
