添加IC卡

向锁里添加一张IC卡，添加后可以用卡开锁，主要有两种添加方式：

（1）通过APP或小程序蓝牙连接锁添加：

开发者可以集成APP SDK开发自己的APP，通过SDK蓝牙连接在锁上添加IC卡，再调用接口（https://api.sciener.com/v3/identityCard/add addType传1），将IC卡添加到云端，方便后续管理。

（2）通过网关或WiFi锁远程添加：

如果是WiFi锁或有连接网关设备，则可以直接调用接口（https://api.sciener.com/v3/identityCard/addForReversedCardNumber，addType传2），通过网关或WiFi锁把IC卡添加到锁里。

注意：调用addForReversedCardNumber接口添加的IC卡，在云端卡号会变，例如请求时的cardNumber是3661413478，通过获取锁名下IC卡列表接口获取到的卡号会是1723612378，这是正常的。

注意：由于不同的读卡器读出来的卡号可能高低位顺序不一样，导致卡号不一样，如果调用接口（https://api.sciener.com/v3/identityCard/addForReversedCardNumber，addType传2）加的卡开不了锁，可以尝试调用接口（https://api.sciener.com/v3/identityCard/add，addType传2）。选中一个接口后，建议别再更换读卡器品牌。

由于锁本身存储空间有限，最多只能写入1000张IC卡，超过个数限制会返回-4056的错误码，提示空间已满，需要先删除其他的，再添加。

添加的IC卡，可以通过获取锁名下IC卡列表接口查询。

1 HTTP请求方法及示例

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


1
curl --location -g --request POST 'https://api.sciener.com/v3/identityCard/addForReversedCardNumber' \
2
--data-urlencode 'clientId=4773aa036f7f49c68d876bb4be85c80c' \
3
--data-urlencode 'accessToken=dfd5489d0cee31f0bdfaf59d0d42d71f' \
4
--data-urlencode 'lockId=163377' \
5
--data-urlencode 'cardNumber=3661413478' \
6
--data-urlencode 'cardName=妈妈的卡' \
7
--data-urlencode 'startDate=1625025703000' \
8
--data-urlencode 'endDate=1645025703000' \
9
--data-urlencode 'addType=2' \
10
--data-urlencode 'date=1625025703000'

2 参数说明

名称	类型	是否必需	描述
clientId	String	Y	创建应用分配的client_id
accessToken	String	Y	访问令牌，通过获取访问令牌接口获取
lockId	Int	Y	锁ID，由锁初始化接口生成
cardNumber	String	Y	IC卡号通过APP SDK在锁上添加时，SDK成功回调会返回卡号；通过网关或WiFi锁远程添加时，请用读卡器读取卡号，读卡器可以联系我司销售购买。
cardName	String	N	IC卡名称
startDate	Long	Y	有效期开始时间（时间戳，单位毫秒）, startDate和endDate都传0 表示永久有效
endDate	Long	Y	有效期结束时间（时间戳，单位毫秒）, startDate和endDate都传0 表示永久有效
cardType	Int	N	卡类型：1、普通卡、4-循环(不传默认1)
cyclicConfig	JSONArray	N	循环时间设置，目前只支持每天开始时间和结束时间一样的设置，示例： `[{"weekDay":1, "startTime":480,"endTime":1080},{"weekDay":2, "startTime":480,"endTime":1080}]` 表示周一和周二8:00到18:00有效
addType	Int	Y	添加方式: 1-通过APP蓝牙添加，不传则默认1，必需先通过APP蓝牙添加后再调用该接口 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-星期天

3 返回参数及示例

参数	类型	描述
cardId	Int	IC卡ID


xxxxxxxxxx
3
1
{
2
    "cardId": 124242
3
}