添加门磁
https://cnapi.ttlock.com/v3/doorSensor/add
门磁可以用来监控门的开关状态。
通过APP SDK给锁添加了门磁后调用该接口,在云端将门磁与锁绑定。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencoded
javascript
curl --location -g --request POST 'https://cnapi.ttlock.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 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| 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 |
{
"doorSensorId": 2323
}