將截圖設置為視頻條目封面
更新時間 2025-04-16 10:39:53
最近更新時間: 2025-04-16 10:39:53
分享文章
用戶可通過本接口將一個截圖設置為視頻條目封面。
接口功能介紹
用戶可通過本接口將一個截圖設置為視頻條目封面。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
POST /xstore-vod/snapshot/picture
請求體body參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| originVideoUuid | 是 | String | 源視頻videoID。 | 494df3af1bd04fc28e2f0c5b73a45b6d | |
| coverUrl | 是 | String | 必填參數，截圖地址。 | //sample.gdoss.xstore.daliqc.cn/%E8%AF%81%E4%B9%A6%E6%89%98%E7%AE%A1.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210113T071722Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=C3IT8A85J8JLV5FN6P27%2F20210113%2Fcn-north-1%2Fs3%2Faws4_request&X-Amz-Signature=e813a45cef8131bd793598ac914607add549eacfcbacee29dfc7756297a1c423 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 0-設置成功；非0-設置失敗 | 0 | |
| message | 是 | String | 錯誤文本信息，成功時，為空字符串。設置失敗時為具體錯誤信息。 | "" | |
| data | 是 | String | 返回的結果。默認無返回數據集。 |
請求示例
請求體body
{
"originVideoUuid":"238435966fdgfdg",
"coverUrl":"//example.gdoss.xstore.daliqc.cn/%E8%AF%81%E4%B9%A6%E6%89%98%E7%AE%A1.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210113T071722Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86400&X-Amz-Credential=C3IT8A85J8JLV5FN6P27%2F20210113%2Fcn-north-1%2Fs3%2Faws4_request&X-Amz-Signature=e813a45cef8131bd793598ac914607add549eacfcbacee29dfc7756297a1c423"
}
響應示例
{
"code":"0",
"message":"",
"data":""
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
