身份证操作
以身份证发钥匙
函数用于用授权该宾客身份证用于开门。
函数 C 语言原型:
int __stdcall KCheckinByCNIDCard(int portName,char *hostURL, char *userName, char *userPasswd,char *deviceID, char *expiryDate, int options,char *returnKeyID, char *returnOwner, char *returnOwnerID);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| portName | int | IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1 |
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| deviceID | char* | 门锁的设备 ID，以 10 进制字符串格式表示, 如果需要指定一卡开多设备（如：电梯控制器），则请用半角‘,’将每个设备 ID 分隔，末尾不要加','（如：‘111,222’） |
| expiryDate | char* | 钥匙失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” |
| options | int | 保留,默认填 0 |
| returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示 注意：需先分配至少 32 字节空间传入 |
| returnOwner | char* | 操作成功后会返回该身份证的姓名 注意：需先分配至少 32 字节空间传入 |
| returnOwnerID | char* | 操作成功后会返回该身份证的号码 注意：需先分配至少 32 字节空间传入 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义), 如果返回 -4，表示多设备操作过程中，与某个设备通信受干扰被中断，请调用修复钥匙操作进行修复。
以身份证号无卡发钥匙
函数用于通过宾客身份证号码授权该身份证用于开门(注意：身份证需至少使用一次读身份证发钥匙操作后才可以使用此函数发授权)。
函数 C 语言原型:
int __stdcall KCheckinByOwnerID(char *hostURL, char *userName, char *userPasswd,char *ownerID, char *deviceID, char *expiryDate, int options,char *returnKeyID, char *returnOwner, char *returnOwnerID);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| ownerID | char* | 客人的身份证号码 |
| deviceID | char* | 门锁的设备 ID，以 10 进制字符串格式表示, 如果需要指定一卡开多设备（如：电梯控制器），则请用半角‘,’将每个设备 ID 分隔，末尾不要加','（如：‘111,222’） |
| expiryDate | char* | 钥匙失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” |
| options | int | 保留,默认填 0 |
| returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示 注意：需先分配至少 32 字节空间传入 |
| returnOwner | char* | 操作成功后会返回该身份证的姓名 注意：需先分配至少 32 字节空间传入 |
| returnOwnerID | char* | 操作成功后会返回该身份证的号码 注意：需先分配至少 32 字节空间传入 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义), 如果返回 -4，表示多设备操作过程中，与某个设备通信受干扰被中断，请调用修复钥匙操作进行修复。
以身份证读钥匙
功能简介：
函数用于读取当前身份证的详细钥匙信息。
函数 C 语言原型:
int __stdcall KReadInfoByCNIDCard(int portName,char *hostURL, char *userName, char *userPasswd,char *returnKeyID, char *returnOwner,char *returnOwnerID, char *returnDeviceID,char *returnExpiryDate);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| portName | int | IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1 |
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示 注意：需先分配至少 32 字节空间传入 |
| returnOwner | char* | 持有人名 注意：需先分配至少 32 字节空间传入 |
| returnOwnerID | char* | 持有人 ID 号码 注意：需先分配至少 32 字节空间传入 |
| returnDeviceID | char* | 门锁的设备 ID，以 10 进制字符串格式表示, 如果该钥匙被指定为一卡开多设备（如：电梯控制器），则每个设备 ID 号之前将以半角‘,’分隔（如：‘111,222’） 注意：需先分配至少 32 字节空间传入 |
| returnExpiryDate | char* | 钥匙失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” 注意：需先分配至少 32 字节空间传入 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义)
以身份证号无卡读钥匙
功能简介：
函数用于以客人的身份证号码检索对应的详细钥匙信息。
函数 C 语言原型:
int __stdcall KReadInfoByOwnerID(char *hostURL, char *userName, char *userPasswd,char * ownerID,char *returnKeyID, char *returnOwner,char *returnOwnerID, char *returnDeviceID,char *returnExpiryDate);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| ownerID | char* | 客人的身份证号码 |
| returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示 注意：需先分配至少 32 字节空间传入 |
| returnOwner | char* | 持有人名 注意：需先分配至少 32 字节空间传入 |
| returnOwnerID | char* | 持有人 ID 号码 注意：需先分配至少 32 字节空间传入 |
| returnDeviceID | char* | 门锁的设备 ID，以 10 进制字符串格式表示, 如果该钥匙被指定为一卡开多设备（如：电梯控制器），则每个设备 ID 号之前将以半角‘,’分隔（如：‘111,222’） 注意：需先分配至少 32 字节空间传入 |
| returnExpiryDate | char* | 钥匙失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” 注意：需先分配至少 32 字节空间传入 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义)
以身份证续住
功能简介：
函数用于给当前身份证续卡(即延长有效时间）。
函数 C 语言原型:
int __stdcall KUpdateExpiryDateByCNIDCard(int portName,char *hostURL, char *userName, char *userPasswd,char *newExpiryDate, int options);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| portName | int | IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1 |
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| newExpiryDate | char* | 钥匙的新失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” |
| options | int | 保留,默认填 0 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义)
以身份证号无卡续住
功能简介：
函数用于给当前身份证号进行无卡续卡(即延长有效时间）。
函数 C 语言原型:
int __stdcall KUpdateExpiryDateByOwnerID(char *hostURL, char *userName, char *userPasswd,char *ownerID, char *newExpiryDate, int options);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| ownerID | char* | 客人的身份证号码 |
| newExpiryDate | char* | 钥匙的新失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” |
| options | int | 保留,默认填 0 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义)
以身份证退卡
功能简介：
函数用于注销当前身份证的开门权限。
函数 C 语言原型:
int __stdcall KCheckoutByCNIDCard(int portName,char *hostURL, char *userName, char *userPasswd,char *returnKeyID);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| portName | int | IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1 |
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示 注意：需先分配至少 32 字节空间传入 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义), 如果返回 -4，表示多设备操作过程中，与某个设备通信受干扰被中断，请调用修复钥匙操作进行修复。
以身份号无卡退卡
功能简介：
函数用于对指定身份证号码进行无卡注销开门权限。
函数 C 语言原型:
int __stdcall KCheckoutByOwnerID(char *hostURL, char *userName, char *userPasswd,char *ownerID, char *returnKeyID);
参数说明
| 参数名 | 类型 | 定义 |
|---|---|---|
| portName | int | IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1 |
| hostURL | char* | 访问后台 URL |
| userName | char* | 访问账号 |
| userPasswd | char* | 访问密码 |
| ownerID | char* | 客人的身份证号码 |
| returnKeyID | char* | 操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示 注意：需先分配至少 32 字节空间传入 |
返回值
0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义), 如果返回 -4，表示多设备操作过程中，与某个设备通信受干扰被中断，请调用修复钥匙操作进行修复。