setDeviceSnap设备抓图

# setDeviceSnap：设备抓图

# 功能详情

设备抓图，支持抓图频率1次/3s。

客户端请求时间间隔需大于等于3s。

备注：

建议开发者根据设备性能实测接口后，来确定使用哪个设备抓图接口：

若设备性能较好（每秒都可以处理并返回抓图图片），则建议开发者调用setDeviceSnapEnhanced接口；

若设备性能较差（主要针对2017年前上市的设备），则建议开发者调用setDeviceSnap接口进行设备抓图。

# 请求地址

https://openapi.lechange.cn/openapi/setDeviceSnap

# 接口请求格式

接口请求方式及部分鉴权参数如sign等计算方式，请参考开发规范 (opens new window)

# 子账户token请求所需最小权限

"Permission":"Capture" "Resource":"cam:序列号:通道号"

# 传入参数说明

参数名	参数类型	是否必填	参数说明
token	String	是	管理员或者子账户accessToken
deviceId	String	是	设备序列号
channelId	String	是	通道号

# 样例输入

{
    "system":{
        "ver":"1.0",
        "appId":"lcdxxxxxxxxx",
        "sign":"1f239a40a252ef1190fc8b1e61bb8b44",
        "time":1603369597,
        "nonce":"755263ee-7301-43c9-9d65-464f0febfc80"
    },
    "id":"c8dd3f09-554b-41dc-8616-76889952e24e",
    "params":{
        "deviceId":"TESTQWERXXXX",
        "channelId":"0",
        "token":"At_00000ad9e6e87f0142eb92e207aec46a"
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 返回data字段说明

字段名		字段类型	字段说明
url		String	抓图访问地址

# 样例输出

{
    "result":{
        "msg":"操作成功。",
        "code":"0",
        "data":{
            "url":"https://lechangecloud.oss-cn-hangzhou.aliyuncs.com/lechange/TESTQWERXXXX_img/Alarm/0/7aa3f5dd3bf1436a87ca1828aad382c3.jpg?Expires=1603974670&OSSAccessKeyId=LTAIP4igXeEjYBoG&Signature=4f7U%2Bgbu3pZXUlL36K14MxFU0IA%3D"
        }
    },
    "id":"c8dd3f09-554b-41dc-8616-76889952e24e"
}

1
2
3
4
5
6
7
8
9
10