Skip to content

添加门磁 ​

https://cnapi.sciener.com/v3/doorSensor/add

门磁可以用来监控门的开关状态。

通过APP SDK给锁添加了门磁后调用该接口,在云端将门磁与锁绑定。

1 HTTP请求方法及示例 ​

POST, ContentType:application/x-www-form-urlencoded

javascript
curl --location -g --request POST 'https://cnapi.sciener.com/v3/doorSensor/add' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'name=大门门磁' \
--data-urlencode 'mac=C9:27:AB:43:22:80' \
--data-urlencode 'firmwareInfo={"modelNum":"SN405_LR","hardwareRevision":"1.3","firmwareRevision":"1.0.0.210903"}' \
--data-urlencode 'number=DS2_a961c2' \
--data-urlencode 'electricQuantity=85' \
--data-urlencode 'date=1625025703000'

2 参数说明 ​

名称类型是否必需描述
clientIdStringY创建应用分配的client_id
accessTokenStringY访问令牌,通过获取访问令牌接口获取
lockIdIntY锁ID,由锁初始化接口生成
nameStringN门磁名称,不传默认用锁别名
electricQuantityIntY门磁电量
firmwareInfoJSONObjectY门磁版本信息
macStringY门磁Mac地址
numberStringY门磁编号
dateLongY当前时间(时间戳,单位毫秒)

firmwareInfo中的参数:

参数类型描述
modelNumString产品型号
hardwareRevisionString硬件版本号
firmwareRevisionString固件版本号

3 返回参数及示例 ​

参数类型描述
doorSensorIdInt门磁ID
{
        "doorSensorId": 2323
}