獲取截圖列表
更新時間 2025-04-16 10:39:52
最近更新時間: 2025-04-16 10:39:52
分享文章
用戶可通過本接口獲得一個視頻條目的全部截圖列表。
接口功能介紹
用戶可通過本接口獲得一個視頻條目的全部截圖列表。
接口約束
本接口的單用戶QPS限制為20次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
URI
GET /xstore-vod/snapshot/picture
請求體 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| originVideoUuid | 是 | String | 源視頻videoID。 | 494df3af1bd04fc28e2f0c5b73a45b6d | |
| snapshotTemplateId | 是 | String | 必填參數，截圖模板ID。 | 100000000001 | |
| watermarkTemplateId | 否 | String | 選填參數，水印模板ID，截圖打水印時傳入該入參。 | 100000000001 |
響應參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| code | 是 | Integer | 本次請求的結果碼。 | 0 | |
| message | 是 | String | 錯誤文本信息。 | "" | |
| data | 是 | Object | 返回的結果。 | data |
表data
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 | 下級對象 |
|---|---|---|---|---|---|
| webVTTFile | 否 | String | WebVTT文件（如有）。 | //test-vod.gdoss.xstore.daliqc.cn/webVTT.vtt | |
| spriteSnapshots | 否 | Array of Strings | 合成雪碧圖或webVTT合成大橫圖（如有）。 | ["//test-vod.gdoss.xstore.daliqc.cn/sprite-0.jpg", "//test-vod.gdoss.xstore.daliqc.cn/sprite-1.jpg"] | |
| originalSnapshots | 否 | Array of Strings | 原始截圖（如有）。 | ["//test-vod.gdoss.xstore.daliqc.cn/snapshot-00.jpg", "//test-vod.gdoss.xstore.daliqc.cn/snapshot-10.jpg"] |
請求示例
請求體Query
?originVideoUuid=&snapshotTemplateId=&watermarkTemplateId=
響應示例
{
"code":"0",
"message":"",
"data":{
"webVTTFile":"//test-vod.gdoss.xstore.daliqc.cn/webVTT.vtt",
"spriteSnapshots":["//test-vod.gdoss.xstore.daliqc.cn/sprite-0.jpg", "//test-vod.gdoss.xstore.daliqc.cn/sprite-1.jpg"],
"originalSnapshots":["//test-vod.gdoss.xstore.daliqc.cn/snapshot-00.jpg", "//test-vod.gdoss.xstore.daliqc.cn/snapshot-10.jpg"]
}
}
狀態碼
| Http 狀態碼 | 狀態碼信息 | 狀態碼描述 |
|---|---|---|
| 0 | 表示業務成功 | 表示業務成功 |
| 400 | 請求參數有誤 | 請求參數有誤 |
| 403 | 用戶鑒權失敗，用戶無操作權限 | 用戶鑒權失敗，用戶無操作權限 |
| 404 | 請求的資源不存在，輸入錯誤的URL | 請求的資源不存在，輸入錯誤的URL |
| 500 | 業務執行異常 | 業務執行異常 |
錯誤碼
OpenAPI錯誤碼請參考 錯誤碼說明。
