密码操作

发时效密码

功能简介:

函数用于用生成开门用时效密码。

函数 C 语言原型:

int __stdcall KCheckinByPassword(char *userName, char *userPasswd,
char *lockID, char *owner, char *ownerID, char *beginDate,
char *expiryDate, int options,
char *returnKeyID, char *returnPassword);

参数说明

参数名类型定义
userNamechar*访问账号
userPasswdchar*访问密码
lockIDchar*门锁的设备 ID,以 10 进制字符串格式表示
ownerchar*持有人名
ownerIDchar*保留
beginDatechar*保留
expiryDatechar*钥匙失效时间的 ISO 8601 格式,如:“2019-09-18T12:00:00.000+08:00”
optionsint保留
returnKeyIDchar*操作成功后会返回新创建的钥匙的钥匙 ID,以 10 进制字符串格式表示
注意:需先分配至少 32 字节空间传入
returnPasswordchar*操作成功后会返回新创建的钥匙的开门密码,以 10 进制字符串格式表示
注意:需先分配至少 32 字节空间传入

注意:时效密码的失效时间有以下要求

  • 使用时效密码时,请确定门锁的时候是准确的,如果门锁长时间停电,请使用手机开一次门,手机在开门时会自动完成时间校准动作。
  • 时效密码可使用的时间为起始时间的 23 小时以内。
  • 时效密码的失效时间只能精确到小时。
  • 小于 365 天的有效时长, 失效时间可精确到指令的小时。
  • 超过 365 天的有效时长,失效时间需为起始时间使用相同日和小时, 比如 2019/9/17 12:00 发的密码,失效时间需为 2020/9/17 12:00。
  • 最大时间长度不可超过 8 年。

返回值

0 表示操作成功,其它值表示失败,请查阅对应的错误码。(返回值定义)