查询截图列表
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | ListStreamScreenshots | 要执行的操作，取值：ListStreamScreenshots。 |
Version | String | 是 | 2023-10-01 | API的版本，取值：2023-10-01。 |
StreamID | String | 是 | e4b32f7a-85cb-4370-aa07-cad62ab4c8a4 | 主码流 ID，可通过调用 ListStreams 接口获取。 |
StreamingIndex | Integer | 否 | 1 | 主子码流编号。
|
Resolution | String | 否 | 2 | 分辨率编码（可参考 GB28181-2022 协议附录G中的定义）。 |
StartTime | Integer | 是 | 1699436336 | 查询录像的开始时间，Unix 时间戳，单位为秒。 |
EndTime | Integer | 是 | 1699436436 | 查询录像的结束时间，Unix 时间戳，单位为秒。 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
Screenshot | Object | 截图 | |
Type | String | record_metadata | 请求类型。 |
Path | String | ve_3wmh/lzd7j67brb2eft9n.push.aiotvideo.volces.com/38d26a12-718e-46eb-b326-bcd450bba84d/ts/1700095456-20231108T164359-6000-1699432678.ts | 请求类型为 ts 分片时，TOS保存ts的路径。 |
POST /?Action=ListStreamScreenshots&Version=2023-10-01 HTTP/1.1 Host: open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20250606T072531Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250606/cn-beijing/aiotvideo/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "StreamID": "e4b32f7a-85cb-4370-aa07-cad62ab4c8a4", "StartTime": 1699436336, "EndTime": 1699436436 }
{ "ResponseMetadata": { "RequestId": "202506061525362040080492306E35A8", "Action": "ListStreamScreenshots", "Version": "2023-10-01", "Service": "aiotvideo", "Region": "cn-beijing" }, "Result": { "Screenshot": { "BornTs": 775 }, "Type": "record_metadata", "Path": "ve_3wmh/lzd7j67brb2eft9n.push.aiotvideo.volces.com/38d26a12-718e-46eb-b326-bcd450bba84d/ts/1700095456-20231108T164359-6000-1699432678.ts" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
500 | NotFoundStream | |
500 | InternalErrorStreamDB |