完成上傳視頻
更新時間 2025-04-16 10:39:49
最近更新時間: 2025-04-16 10:39:49
分享文章
視頻上傳完成后通過本接口實現云端合并入庫。
接口功能介紹
在視頻分片上傳完畢后，可通過本接口完成視頻上傳流程。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
POST /video/create/complete
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 視頻ID | 34c71dba-f280-4f5e-a05f-f4daed837fef | |
| etags | 是 | Array of Objects | 每個分片eTag信息的列表。必須將所有分片的eTag信息都傳入。 | etags |
表 etags
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| partNumber | 是 | Integer | 分片編號，從 1 開始。 | 1 | |
| eTag | 是 | String | eTag字符串，由上傳視頻分片成功后的Response的eTag頭部取得。 | f2a7e5e125df0be8e9098df369b32486-1 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息，創建成功時，為空字符串。 | "" | |
| data | 是 | Object | 返回數據。 | data |
表data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| videoId | 是 | String | 視頻的 id，僅可用在 完成上傳視頻接口以及 刪除視頻接口。 |
34c71dba-f280-4f5e-a05f-f4daed837fef | |
| videoUrl | 是 | String | 視頻的 url。 | //example.gdoss.xstore.daliqc.cn/bucket/uploadPart?partNum=1signature=xxxxxx |
請求示例
{
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"etags": [
{
"partNumber": 1,
"eTag": "f2a7e5e125df0be8e9098df369b32486-1"
}, {
"partNumber": 2,
"eTag": "f2a7e5e125df0be8e9098df369b32486-2"
}
]
}
響應示例
{
"code": 0,
"message": "",
"data" : {
"videoId": "34c71dba-f280-4f5e-a05f-f4daed837fef",
"videoUrl": "//example.gdoss.xstore.daliqc.cn/bucket/xxxx.mp4"
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
