删除IC卡
https://cnapi.ttlock.com/v3/identityCard/delete
删除之前添加的IC卡,主要有两种删除方式:
(1)通过APP或小程序蓝牙连接锁删除:
开发者可以集成APP SDK开发自己的APP,通过蓝牙方法从锁里删除IC卡,再调用该接口(deleteType传1),将IC卡从云端的数据库里删除。
(2)通过网关或WiFi锁远程删除:
如果是WiFi锁或有连接网关设备,则可以直接调用该接口(deleteType传2),通过网关或WiFi锁把IC卡从锁里删除。
1 HTTP请求方法及示例
POST, ContentType:application/x-www-form-urlencoded
javascript
curl --location -g --request POST 'https://cnapi.ttlock.com/v3/identityCard/delete' \
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
--data-urlencode 'lockId=163377' \
--data-urlencode 'cardId=124242' \
--data-urlencode 'deleteType=2' \
--data-urlencode 'date=1625025703000'2 参数说明
| 名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| clientId | String | Y | 创建应用分配的client_id |
| accessToken | String | Y | 访问令牌,通过获取访问令牌接口获取 |
| lockId | Int | Y | 锁ID,由锁初始化接口生成 |
| cardId | Int | Y | 卡ID,由添加IC卡接口生成 |
| deleteType | Int | Y | 删除方式: 1-通过APP走蓝牙删除,不传默认1,必需先通过APP蓝牙删除后再调用该接口 2-通过网关或WiFi锁删除,如果是WiFi锁或有连接网关,则可以传2,直接调用该接口从锁里删除IC卡 3-NB-IoT,如果是NB-IoT锁,可以传3,通过NB网络删除,待NB唤醒后下发删除指令。 |
| date | Long | Y | 当前时间(时间戳,单位毫秒) |
3 返回参数及示例
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | Int | 错误码 |
| errmsg | String | 错误信息 |
| description | String | 错误描述 |
{
"errcode": 0,
"errmsg": "none error message",
"description":"表示成功或是"
}