接口说明:
如果密码开不了锁,在三方面进行排查 1、门锁时间是否正确(通过同步门锁时间来解决) 2、生成密码的aesKey、鉴权码是否和门锁上的一致(门锁初始化后,aesKey和鉴权码都会重新生成) 3、同一个时间生成的第一个密码输入可以开门,删除后再次相同开始结束时间生成的密码是无法开门的
- 离线发卡
- 房间封房状态不能授权离线发卡
- 最多选择4个房间
需要将卡片放入关联的发卡器
业务能力:
- openSmartAddCardKey
本地服务器版本:
- V3.2.0
Content-Version:
- 1.1
参数:
参数名 | 层级 | 类型 | 条件 | 描述 | 备注 |
---|---|---|---|---|---|
lockCodes | 1 | list<String> | 必填 | 门锁号 | 最多选择4个 可通过房间列表查看 |
customerName | 1 | String | 必填 | 房客名称 | 1.6.1版本,改为可选,当为空时, 默认取卡号为房客名 |
copyCheckIn | 1 | int | 必填 | 复制入住 | 本地服务器V1.4.1版本: 0 不复制入住,开始时间取推送过来入住的当前时间,且对房间做退房逻辑 1 复制入住,存在房客入住以房客最早开始时间为准 本地服务器V1.5.0版本: 0 退房后入住 先将对应房源内的所有房客退房(删除授权)再入住(执行当前的新授权),取入参开始时间作为本次入住授权的起始时间(时间精度为小时) 1 立即入住 不删除对应房源内的原有授权,以已入住房客授权的开始时间作为本次入住授权的开始时间,如对应房源内没有已入住的房客,则取当前时间作为本次入住授权的开始时间(时间精度为小时) 2 其他时间入住 不删除对应房源内的原有授权,取入参开始时间作为本次入住授权的起始时间(可以为未来时间,时间精度为小时) 备注: 1.房间门锁开启顶替功能,如果入住时间触发其他授权顶替,服务器则会有异常提示,第三方需要调整入住时间。 2.房间开启顶替的情况下,该接口只能选0进行入住。 |
idType | 1 | int | 可选 | 证件类型 | 1身份证 2护照 9其他 |
idNumber | 1 | String | 可选 | 证件号 | 最大支持100个字符 |
beginTime | 1 | long | 必填 | 开始时间 | 时间戳,单位秒 |
endTime | 1 | long | 必填 | 结束时间 | 时间戳,单位秒 |
isLock | 1 | int | 可选 | 是否允许开反锁 | 1.6.1版本新增字段:0不允许开反锁,1允许开反锁,不填默认为0 |
floorList | 1 | list | 可选 | 可开楼层 | 2.7.3新增 |
floorCode | 2 | int | 可选 | 楼层码 | 2.7.3新增 |
请求示例 |
{
"tokenId": "aFqJ9GbjlmX0LHZosmciPH3Ewt4S53Fdt/AX7/to/I8IDaYsFkk1cIkz5Ez2Y/PvhDDKWppSuXv1QLcPyLjF+g==",
"method": "openSmartAddCardKey",
"data": {
"lockCodes": ["1.2.201A","1.2.210"],
"customerName":"zzy",
"copyCheckIn":0,
"idType":1,
"idNumber":"1231231",
"beginTime":1602165958,
"endTime":1608965958
}
}
响应示例
{
"msgId": 77568002,
"resultCode": 0,
"reason": "",
"method": "openSmartAddCardKey",
"list": [
{
"checkInId": "h0JYf4V93p4=",
"checkInName": "zzy",
"beginTime": 1602165600,
"endTime": 1608965958,
"idType": 1,
"idNumber": "1231231",
"cardNo": "DB730487"
}
]
}
响应参数说明
参数名 | 层级 | 类型 | 条件 | 描述 | 备注 |
---|---|---|---|---|---|
list | 1 | list | 必填 | -- | |
checkInId | 2 | String | 必填 | 入住ID | -- |
checkInName | 2 | String | 必填 | 用户姓名 | -- |
idType | 2 | int | 可选 | 证件类型 | 1身份证 2护照 9其他 |
idNumber | 2 | String | 可选 | 证件号 | -- |
beginTime | 2 | int | 必填 | 开始时间 | 时间戳:单位秒 |
endTime | 2 | int | 必填 | 结束时间 | 时间戳:单位秒 |
cardNo | 2 | String | 必填 | 卡号 | -- |
异常码
异常码 | 异常描述 |
---|---|
500001 | 参数异常 |
500209 | 未绑定发卡器 |
500300 | 房间不存在 |
500400 | 非法卡片 |
500402 | 卡片已使用,请回收后再制卡 |
500403 | 未读取到卡片信息 |
500503 | 重复授权 |
500508 | PMS入住不允许直接操作,请前往PMS页面操作 |