接口说明:

  • 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

参数:

参数名层级类型条件描述备注
lockCode1String必填门锁号可通过房间列表查看
customerName1String必填房客名称--
copyCheckIn1int必填复制入住本地服务器V1.4.1版本:
0 不复制入住,开始时间取推送过来入住的当前时间,且对房间做退房逻辑
1 复制入住,存在房客入住以房客最早开始时间为准

本地服务器V1.5.0版本:
0 退房后入住
先将对应房源内的所有房客退房(删除授权)再入住(执行当前的新授权),取入参开始时间作为本次入住授权的起始时间(时间精度为小时)
1 立即入住
不删除对应房源内的原有授权,以已入住房客授权的开始时间作为本次入住授权的开始时间,如对应房源内没有已入住的房客,则取当前时间作为本次入住授权的开始时间(时间精度为小时)
2 其他时间入住
不删除对应房源内的原有授权,取入参开始时间作为本次入住授权的起始时间(可以为未来时间,时间精度为小时)
备注:
房间门锁开启顶替功能,如果入住时间触发其他授权顶替,服务器则会有异常提示,第三方需要调整入住时间。
如若该门锁为门禁时,只能选1和2。
房间开启顶替的情况下,该接口只能选0进行入住。
idType1int可选证件类型1身份证
2护照
9其他
idNumber1String可选证件号最大支持100个字符
beginTime1long必填开始时间时间戳,单位秒
endTime1long必填结束时间时间戳,单位秒
请求示例
{
	"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=="
	}
}

响应参数说明

参数名层级类型条件描述备注
checkInId1String必填入住ID--
checkInName1String必填用户姓名--
idType1int可选证件类型1身份证
2护照
9其他
idNumber1String可选证件号--
beginTime1long必填开始时间时间戳:单位秒
endTime1long必填结束时间时间戳:单位秒
password1String必填密码AES加密

异常码

异常码异常描述
500001参数异常
500300房间不存在
500316房间未关联门锁
500508PMS入住不允许直接退房,请前往PMS页面操作