https://api.sciener.com/v3/identityCard/changePeriod
修改IC卡有效期,主要有两种修改方式:
开发者可以集成APP SDK开发自己的APP,通过蓝牙修改IC卡有效期,再调用该接口(changeType传1),将修改后的有效期同步到云端。
如果是WiFi锁或有连接网关设备,则可以直接调用该接口(changeType传2),通过网关或WiFi锁直接修改锁里IC卡的有效期。
xxxxxxxxxxcurl --location -g --request POST 'https://api.sciener.com/v3/identityCard/changePeriod' \--data-urlencode 'clientId=fd2ff35ee3xxxxxx' \--data-urlencode 'accessToken=780f7671b6e6bxxxxxxx' \--data-urlencode 'lockId=24451' \--data-urlencode 'cardId=124242' \--data-urlencode 'startDate=1626945087000' \--data-urlencode 'endDate=1846945087000' \--data-urlencode 'changeType=2' \--data-urlencode 'date=1626945087000'| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| cardId | Int | Y | 卡ID,由添加IC卡接口生成 |
| startDate | Long | Y | 修改后密码有效期开始时间(时间戳,单位毫秒),不支持修改成永久 |
| endDate | Long | Y | 修改后密码有效期结束时间(时间戳,单位毫秒),不支持修改成永久 |
| cyclicConfig | JSONArray | N | 循环时间设置,目前只支持每天开始时间和结束时间一样的设置,示例:[{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}] 表示周一和周二8:00到18:00有效 |
| changeType | Int | Y | 修改方式: 1-通过APP走蓝牙修改,不传默认1,必需先通过APP SDK蓝牙修改后调用该接口 2-通过网关或WiFi锁修改,如果是WiFi锁或有连接网关,则可以传2,直接调用该接口修改生效 3-NB-IoT,如果是NB-IoT锁,可以传3,通过NB网络下发指令,要等NB唤醒才会下发生效。 |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
cyclicConfig中的参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| startTime | Int | 开始时间,分钟数, 例如 480 代表 8:00 |
| endTime | Int | 结束时间,分钟数, 例如 1080 代表 18:00 |
| weekDay | Int | 星期:1-7, 1-星期一...7-星期天 |
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | Int | 错误码 |
| errmsg | String | 错误信息 |
| description | String | 错误描述 |
xxxxxxxxxx{"errcode": 0,"errmsg": "none error message","description":"表示成功或是"}