指令抓图
接口调用说明
请求地址 : /v1/api/device/control_stream_snapshot
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
| channelId | int | 是 | 视频通道号 |
| frameTime | string | 否 | 抓图时间点，非必填，格式yyyyMMddHHmmss ，不填的情况下抓实况图; 如果设备开通智能编码，抓图时间点会有误差; |
//示例数据
{
"deviceSn" : "**********",//设备序列号
"channelId" : 0,//视频通道号
"frameTime" : "20250804120000"//抓图时间点
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 否 | 返回内容 |
data内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| url | String | 是 | 图片地址，有效期 5min |
| encryptIv | String | 是 | 加密图片的初始向量 |
| workingKey | String | 是 | 加密图片的工作密钥 |
//示例数据
{
"code":1000,//状态码
"msg":"OK",//状态码解释信息
"data":{
"url":"https://viewleader.oss-cn-qingdao.aliyuncs.com/Alarm%2F**********_0_1600168457310?Expires=1600168762&OSSAccessKeyId=LTAI4GK15nydKttqKG9yZSWK&Signature=JZ0XPOllEyobwQTYbmLb2UY4lhs%3D",
"encryptIv":"V1sPjLJ9eWILVuT0",
"workingKey":"EevvJQ0INuuaMPyv2QFSOzGlCZLMfKZa"
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken异常或过期 |
| 2002 | 设备不在线 |
| 2008 | 设备不存在 |
| 4003 | 本地资源不存在 |