接口功能介绍
查询指定时间段内的截图内容。
使用说明
支持返回jpg、png等格式截图文件路径。
接口详情
请求方式：POST
请求路径：/live/snapshot/query-snapshot-content
请求JSON参数
| 参数名 | 类型 | 名称 | 是否必填 | 说明 |
|---|---|---|---|---|
| domain | str | 域名 | 是 | 域名 |
| app_name | str | 频道名 | 是 | 发布点(频道名) 以字母或者数字开头/结尾，中间可包含- |
| stream_name | str | 流名 | 是 | 流名 以字母或者数字开头/结尾，中间可包含- |
| StartTime | str | 开始时间 | 是 | 开始时间。 格式为：yyyyMMddHHmm 示例：202202022020 |
| EndTime | str | 结束时间 | 是 | 结束时间。 格式为：yyyyMMddHHmm 示例：202202022220 EndTime和StartTime之间的间隔不能超过1小时 |
响应JSON参数
| 参数名 | 类型 | 名称 |
|---|---|---|
| code | int | 状态码 |
| message | str | 信息描述 |
| SnapshotInfoList | list | 截图列表 |
| SnapshotInfoList:OssObjectPrefix | dict | 截图存储信息 |
| OssBucket | str | OSS的Bucket名称 |
| OssRegion | str | OSS的Region名称 |
| OssEndpoint | str | OSS的服务地址 |
示例
请求路径：https://cdnapi-global.ctapi.ctyun.cn/live/snapshot/query-snapshot-content
请求JSON示例
{
"domain":"ctyun.cn",
"app_name":"live",
"stream_name":"stream01",
"StartTime":"202209010220",
"EndTime":"202209010320"
}
正常响应JSON示例
{
"code": 100000,
"message": "success",
"SnapshotInfoList": [
{
"OssObjectPrefix": "pic/live/stream01/20220901022011.png"
},
{
"OssObjectPrefix": "snapshot/live/stream01/20220901022011.png"
}
],
"OssBucket": "test001",
"OssRegion": "R0001",
"OssEndpoint": "test3"
}
