取得視頻文件
更新時間 2025-04-16 10:39:51
最近更新時間: 2025-04-16 10:39:51
分享文章
通過本接口獲取媒體庫源視頻相關視頻文件集合。
接口功能介紹
用戶可通過本接口獲取媒體庫源視頻相關視頻文件集合。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
POST /video/files
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 源視頻id | 34c71dba-f280-4f5e-a05f-f4daed837fef |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息，創建成功時，為空字符串。 | "" | |
| data | 是 | Array of Objects | 返回數據。 | data |
表 data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 源視頻id | 34c71dba-f280-4f5e-a05f-f4daed837fef | |
| type | 是 | String | 視頻類型，包含 ORIGINAL(源視頻)/MASTER_M3U8(自適應的主m3u8文件)/TRANSCODED(轉碼后視頻)。 | TRANSCODED | |
| fileId | 是 | String | 文件id | 34c71dba-f280-4f5e-a05f-f4daed837fef/100001.m3u8 | |
| url | 是 | String | 視頻播放的url，返回數據庫中當前的url，如果沒有調用簽名接口簽名，返回的是無簽名的url，如果有調用則是上一次簽名的url。 | //example.gdoss.xstore.daliqc.cn/vod-transcoded-xxxxx/34c71dba-f280-4f5e-a05f-f4daed837fef/100001_signed.m3u8?signature=xxxxx&Expires=1111111 | |
| transcodeTemplateId | 否 | Long | 視頻對應的轉碼模板id，只有源視頻存在轉碼后的文件集才會返回。 | 100000000003 |
請求示例
請求體body
{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef"
}
響應示例
{
"code": 0,
"message": "",
"data": [{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"type": "ORIGINAL",
"fileId": "34c71dba-f280-4f5e-a05f-f4daed837fef/100001.m3u8",
"url": "//example.gdoss.xstore.daliqc.cn/vod-transcoded-xxxxx/34c71dba-f280-4f5e-a05f-f4daed837fef/100001_signed.m3u8?signature=xxxxx&Expires=1111111"
}, {
"videoId": "34c71dba-f280-4f5e-a05f-d12r4d2f12f2",
"type": "TRANSCODED",
"fileId": "34c71dba-f280-4f5e-a05f-f4daed837fef/100007.m3u8",
"transcodeTemplateId": 100000000003,
"url": "//example.gdoss.xstore.daliqc.cn/vod-transcoded-xxxxx/34c71dba-f280-4f5e-a05f-f4daed837fef/100007_signed.m3u8?signature=xxxxx&Expires=1111111"
}
]
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
