获取截图列表
描述
本接口用于查询流截图记录
- 接口请求域名:
qvs.qiniuapi.com
- 请求方式:GET
- 接口路径:
/v1/namespaces/{namespaceId}/streams/{streamId}/snapshots?type=<type>&start=<start>&end=<end>&marker=<marker>&line=<line>
请求参数
路径参数
参数名称 | 必填 | 字段类型 | 说明 |
---|---|---|---|
namespaceId | 是 | string | 空间名称ID |
streamId | 是 | string | 流ID |
line | 否 | integer | 限定返回截图的个数,只能输入1-100的整数,不指定默认返回30个,type为3可忽略 |
marker | 否 | string | 上一次查询返回的标记,用于提示服务端从上一次查到的位置继续查询,不指定表示从头查询,type为3可忽略 |
start | 否 | integer | 查询开始时间(unix时间戳,单位为秒),type为3可忽略 |
end | 否 | integer | 查询结束时间(unix时间戳,单位秒),type为3可忽略 |
type | 是 | integer | 1:实时截图对应的图片列表 2: 按需截图对应的图片列表 3:覆盖式截图对应的图片 |
响应参数
参数名称 | 类型 | 说明 |
---|---|---|
items | 截图数组 | 截图数组 |
items.snap | string | 截图url |
items.time | integer | 截图时间点(unix时间戳 单位为秒),覆盖式截图不返回 |
marker | string | 返回的列举位置标记,作为下次列举的起点信息,为空表示全部返回完毕,覆盖式截图不返回 |
示例
请求示例
curl --request GET \
--url http://qvs.qiniuapi.com/v1/namespaces/d102sni9zryu/streams/device005/snapshots?type=1&start=1586828065&end=1586828456 \
--header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
响应示例
{
"items": [
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828065507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:yQlQDLIQ26Hi9jcZd9-TnyDzI18",
"time": 1586828065
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828070507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:YSYRJ4MmLpS4qzQt41DzseP68R4",
"time": 1586828070
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828075507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:UXYXpZloJ2UriMJEh11hPlU7yFg",
"time": 1586828075
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828080507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:sa8C-5BAuFyT_9ATudyc-z-KxtI",
"time": 1586828080
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828085507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:atGE_HnerdP2TF1fDSlv2HRurcw",
"time": 1586828085
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828090507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:-Y60QNphmQXR_55dJjZwZsR3kjM",
"time": 1586828090
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828095507.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:7ANfnFBW89-1NjOe6dDSBIA2cMc",
"time": 1586828095
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828100508.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:P8kzLrxZMP3un_-XUFOizkZaANw",
"time": 1586828100
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828105508.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:T9QOjrffHcso1RSp8dloc2ZdyqA",
"time": 1586828105
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828110508.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:74yrgiYxCZeIItQXmmWTxMVBxrw",
"time": 1586828110
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828115508.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:TNHVuUTStr8ezapllWCgQiQn47U",
"time": 1586828115
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828120508.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:V4IxtbtocODKZBhnickurPpRY5U",
"time": 1586828120
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828125508.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:A-yZ33E0SOQ5hWfZCRNEoHuNnUQ",
"time": 1586828125
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828401725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:-CoBGlhZYG-uHb41Ef3NK8gC4RA",
"time": 1586828401
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828406725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:NZGmCuPirRHSaUle1uan3r5UEN8",
"time": 1586828406
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828411725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:yMfBgqCfs7moXWNHFbhE7vM8sRs",
"time": 1586828411
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828416725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:_JyY_tY-IgjIa7R2pTaeZHfEWPI",
"time": 1586828416
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828421725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:LoKfTgNXtt7h3abYCubB_Z_HS6Q",
"time": 1586828421
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828426725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:0OhkDmGGosGTPocc5-nP-orLtzw",
"time": 1586828426
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828431725.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:z1Lnuo_dlIH0QREYGTGlTbYfCvA",
"time": 1586828431
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828436726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:HhhuyOA3fta0RsIhqDxjJXlL2mw",
"time": 1586828436
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828441726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:2l1sNUt_52nENC-KDgV6C-K_7sc",
"time": 1586828441
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828446726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:3zQ-NVWgU-ZfZhxxoc7D6x8M4jU",
"time": 1586828446
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828451726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:0HUzUUE82KpP6fwos59jSt251sI",
"time": 1586828451
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828456726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:u8Enxseu4TlyMo7T32FrfKi90Zw",
"time": 1586828456
},
{
"snap": "http://prlghu509.test.bkt.clouddn.com/snapshot/jpg/d102sni9zryu/device005/1586828461726.jpg?e=1586829199&token=Ves3WTXC8XnEHT0I_vacEQQz-9jrJZxNExcmarzQ:AcRKnwvxxDc4kgg22RwbaiiAJYM",
"time": 1586828461
}
],
"marker": ""
}
文档反馈
(如有产品使用问题,请提交工单)