指令抓图
接口调用说明
请求地址 : /v1/api/device/control_stream_snapshot
请求方式 : POST
请求头
| 参数名 | 参数值 | 是否必须 |
|---|---|---|
| Content-Type | application/json | 是 |
| X-Token | 实际accessToken | 是 |
请求报文体
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| deviceSn | String | 是 | 设备序列号 |
| channelId | int | 是 | 视频通道号 |
//示例数据
{
"deviceSn" : "**********",//设备序列号
"channelId" : 0//视频通道号
}
响应报文
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| code | int | 是 | 状态码 |
| msg | String | 是 | 状态码解释信息 |
| data | Object | 否 | 返回内容 |
data内容如下:
| 名称 | 类型 | 是否必须 | 备注 |
|---|---|---|---|
| url | String | 是 | 图片地址，有效期 30min |
| encryptIv | String | 是 | 加密图片的初始向量 |
| workingKey | String | 是 | 加密图片的工作密钥 |
//示例数据
{
"code":1000,//状态码
"msg":"OK",//状态码解释信息
"data":{
"url":"https://xxxxxxxxxxxxxxxxxxxx/Alarm%xxxxxxxxxxxxxxxxx?Expires=xxxxxxxx&OSSAccessKeyId=xxxxxxxxxxx&Signature=xxxxxxxxxxxx%3D",
"encryptIv":"xxxxxxxxxxxxx",
"workingKey":"xxxxxxxxxxxxxxxxx"
}
}
错误码
| 状态码 | 状态描述 |
|---|---|
| 1000 | 成功 |
| 1001 | 参数错误 |
| 1002 | 请求异常 |
| 1006 | AccessToken异常或过期 |
| 2002 | 设备不在线 |
| 2008 | 设备不存在 |