獲取音視頻文件元數據信息
更新時間 2025-04-16 10:39:53
最近更新時間: 2025-04-16 10:39:53
分享文章
獲取音視頻文件元數據信息接口功能描述。
接口功能介紹
通過本接口可獲取存放在云點播存儲桶內的音視頻文件的元數據信息。由于獲取元數據信息需要較長時間拉取文件樣本,為保證業務流程運轉流暢,本接口被設定為異步調用方式。用戶在接口中僅需提供源文件訪問地址(必須為云點播產品合法的存儲桶地址),后臺在接收到請求后,會通過HTTP POST方法將結果(JSON格式)返回。異步回調數據格式可參考以下文檔。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。
URI
POST /metadata/task
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| visitUrl | 是 | String | 源文件訪問地址 | //bucketname.gdoss.xstore.daliqc.cn/video.mp4 | |
| clientCallbackUrl | 是 | String | 用戶自建的回調接收服務地址。 | //callback.daliqc.cn/Callback |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息,創建成功時,為空字符串。 | "" | |
| data | 是 | Object | 返回數據。 | data |
表data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| taskId | 是 | String | 獲取元數據任務的ID。 | c39c5d5b11b849508f3a9b98a27d1310 |
請求示例
{
"visitUrl": "//bucketname.gdoss.xstore.daliqc.cn/video.mp4",
"clientCallbackUrl": "//callback.daliqc.cn/Callback"
}
響應示例
{
"code":"0",
"message":"",
"data": {
"taskId": "c39c5d5b11b849508f3a9b98a27d1310"
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗,用戶無操作權限 | 用戶鑒權失敗,用戶無操作權限 |
| 404 | 請求的資源不存在,輸入錯誤的URL | 請求的資源不存在,輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。