添加门磁

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

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

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

1 HTTP请求方法及示例

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

xxxxxxxxxx
10
1
curl --location -g --request POST 'https://api.sciener.com/v3/doorSensor/add' \
2
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
3
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
4
--data-urlencode 'lockId=163377' \
5
--data-urlencode 'name=大门门磁' \
6
--data-urlencode 'mac=C9:27:AB:43:22:80' \
7
--data-urlencode 'firmwareInfo={"modelNum":"SN405_LR","hardwareRevision":"1.3","firmwareRevision":"1.0.0.210903"}' \
8
--data-urlencode 'number=DS2_a961c2' \
9
--data-urlencode 'electricQuantity=85' \
10
--data-urlencode 'date=1625025703000'

2 参数说明

名称	类型	是否必需	描述
clientId	String	Y	创建应用分配的client_id
accessToken	String	Y	访问令牌，通过获取访问令牌接口获取
lockId	Int	Y	锁ID，由锁初始化接口生成
name	String	N	门磁名称，不传默认用锁别名
electricQuantity	Int	Y	门磁电量
firmwareInfo	JSONObject	Y	门磁版本信息
mac	String	Y	门磁Mac地址
number	String	Y	门磁编号
date	Long	Y	当前时间（时间戳，单位毫秒）

firmwareInfo中的参数：

参数	类型	描述
modelNum	String	产品型号
hardwareRevision	String	硬件版本号
firmwareRevision	String	固件版本号

3 返回参数及示例

参数	类型	描述
doorSensorId	Int	门磁ID

xxxxxxxxxx
3
1
{
2
        "doorSensorId": 2323
3
}