添加遥控
https://cnapi.sciener.com/v3/remote/add
使用APP SDK完成遥控的初始化后,调用该接口将遥控添加到云端,方便后续管理。
允许一把锁添加多个遥控。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencoded
javascript
curl --location -g --request POST 'https://cnapi.sciener.com/v3/remote/add' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'number=RC_a8179f' \
--data-urlencode 'name=大门锁遥控' \
--data-urlencode 'mac=33:33:33:33:33:33' \
--data-urlencode 'startDate=1625025703000' \
--data-urlencode 'endDate=1645025703000' \
--data-urlencode 'type=1' \
--data-urlencode 'electricQuantity=86' \
--data-urlencode 'firmwareInfo={"modelNum":"SN351_PV53","hardwareRevision":"1.1","firmwareRevision":"6.0.0.210311"}' \
--data-urlencode 'date=1625025703000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| number | String | Y | 遥控编号 |
| name | String | N | 名称 |
| mac | String | Y | Mac |
| startDate | Long | Y | 有效期开始时间 |
| endDate | Long | Y | 有效期结束时间 |
| type | Int | N | 类型:1、普通、4-循环(不传默认1) |
| cyclicConfig | JsonArray | N | 循环时间设置(循环类型的才需要传) 示例: [{"startTime":480, "endTime":1080,"weekDay":1},{"startTime":480, "endTime":1080,"weekDay":2}] 表示周一和周二8:00到18:00有效 |
| electricQuantity | Int | Y | 电量 |
| firmwareInfo | JSONObject | Y | 固件版本信息 |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| remoteId | Int | 遥控ID |
{
"remoteId": 4242
}