密码操作
发时效密码
功能简介:
函数用于用生成开门用时效密码。
函数 C 语言原型:
int __stdcall KCheckinByPassword(char *userName, char *userPasswd,char *lockID, char *owner, char *ownerID, char *beginDate,char *expiryDate, int options,char *returnKeyID, char *returnPassword);
参数说明
参数名 | 类型 | 定义 |
---|---|---|
userName | char* | 访问账号 |
userPasswd | char* | 访问密码 |
lockID | char* | 门锁的设备 ID,以 10 进制字符串格式表示 |
owner | char* | 持有人名 |
ownerID | char* | 保留 |
beginDate | char* | 保留 |
expiryDate | char* | 钥匙失效时间的 ISO 8601 格式,如:“2019-09-18T12:00:00.000+08:00” |
options | int | 保留 |
returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID,以 10 进制字符串格式表示 注意:需先分配至少 32 字节空间传入 |
returnPassword | char* | 操作成功后会返回新创建的钥匙的开门密码,以 10 进制字符串格式表示 注意:需先分配至少 32 字节空间传入 |
注意:时效密码的失效时间有以下要求
- 使用时效密码时,请确定门锁的时候是准确的,如果门锁长时间停电,请使用手机开一次门,手机在开门时会自动完成时间校准动作。
- 时效密码可使用的时间为起始时间的 23 小时以内。
- 时效密码的失效时间只能精确到小时。
- 小于 365 天的有效时长, 失效时间可精确到指令的小时。
- 超过 365 天的有效时长,失效时间需为起始时间使用相同日和小时, 比如 2019/9/17 12:00 发的密码,失效时间需为 2020/9/17 12:00。
- 最大时间长度不可超过 8 年。
返回值
0 表示操作成功,其它值表示失败,请查阅对应的错误码。(返回值定义)