接口说明:
- 1、如果密码的有效期小于1年,密码的有效期,精确到小时 如: 开始时间:2019-06-21 11:16:14 结束时间:2019-06-21 13:16:14 那么有效时间为:2019-06-21 11:00:00---2019-06-21 13:00:00
- 2、如果密码的有效期大于1年,密码的有效期精确到月 如: 开始时间:2019-06-21 11:16:14 结束时间:2020-09-21 11:16:14 那么有效时间为:2019-06-01 00:00:00---2020-09-01 00:00:00
如果密码开不了锁,在三方面进行排查 1、门锁时间是否正确(通过同步门锁时间来解决) 2、生成密码的aesKey、鉴权码是否和门锁上的一致(门锁初始化后,aesKey和鉴权码都会重新生成) 3、同一个时间生成的第一个密码输入可以开门,删除后再次相同开始结束时间生成的密码是无法开门的
- 授权离线密码钥匙 限制:
- 有效时间不能超过3年
- 有效时间超过1年,精确到月;有效时间小于1年,精确到小时
- 房间封房状态不能授权离线密码钥匙
业务能力:
- openSmartAddOffLineKey
本地服务器版本:
- V1.4.1
Content-Version:
- 1.0
参数:
参数名 | 层级 | 类型 | 条件 | 描述 | 备注 |
---|---|---|---|---|---|
lockCode | 1 | String | 必填 | 门锁号 | 可通过房间列表查看 |
customerName | 1 | String | 必填 | 房客名称 | -- |
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 | 必填 | 结束时间 | 时间戳,单位秒 |
请求示例 |
{
"tokenId": "aFqJ9GbjlmX0LHZosmciPH3Ewt4S53Fdt/AX7/to/I8IDaYsFkk1cIkz5Ez2Y/PvhDDKWppSuXv1QLLjF+g==",
"method": "openSmartAddOffLineKey",
"data": {
"lockCode": "1.1.103",
"customerName":"zzy",
"copyCheckIn":0,
"idType":1,
"idNumber":"1231231",
"beginTime":1603265958,
"endTime":1608265958
}
}
响应示例
{
"msgId": 2107619328,
"resultCode": 0,
"reason": "",
"method": "openSmartAddOffLineKey",
"data": {
"checkInId": "vKucPeOPw54=",
"checkInName": "zzy",
"beginTime": 1603263600,
"endTime": 1608265958,
"idType": 1,
"idNumber": "1231231",
"password": "ryizXPc1I8ZNzusrM8MnMw=="
}
}
响应参数说明
参数名 | 层级 | 类型 | 条件 | 描述 | 备注 |
---|---|---|---|---|---|
checkInId | 1 | String | 必填 | 入住ID | -- |
checkInName | 1 | String | 必填 | 用户姓名 | -- |
idType | 1 | int | 可选 | 证件类型 | 1身份证 2护照 9其他 |
idNumber | 1 | String | 可选 | 证件号 | -- |
beginTime | 1 | long | 必填 | 开始时间 | 时间戳:单位秒 |
endTime | 1 | long | 必填 | 结束时间 | 时间戳:单位秒 |
password | 1 | String | 必填 | 密码 | AES加密 |
异常码
异常码 | 异常描述 |
---|---|
500001 | 参数异常 |
500300 | 房间不存在 |
500316 | 房间未关联门锁 |
500508 | PMS入住不允许直接退房,请前往PMS页面操作 |