海康威视新固件人脸识别终端OpenAPI添加人员失败求助

通过OpenAPI向海康威视人脸识别终端添加人员时，旧固件版本（如20220310）的设备可成功完成操作，但升级到新固件版本（如20230208）的设备返回错误码0x60000017（Invalid JSON Format）。已参照官方手册调整请求参数格式，问题仍未解决。

请求与响应示例 #

添加人员请求 #

{"employeeNo": "10", "type": 1, "familyName": "aa", "givenName": "aa", "email": "aaa@mail.ru", "phone": "12344535", "facePicture": "/9j/4AAQSkZJRgABAQAAAQABAAD/...", "cardNo": "10"}

人员状态响应 #

{"data": [{"personId": "8a748377896ebfe10189732317f51575", "deviceLists": [{"deviceSerial": "L35855384", "status": 2, "subStatus": 0, "error": "0x60000017"}]}], "errorCode": "0"}

排查方向 #

• 严格校验JSON格式：新固件对JSON格式的容错性更低，确保所有键名和字符串值均使用双引号，无末尾多余逗号、语法错误。
• 验证facePicture编码：确认人脸图片的Base64编码完整、无换行或特殊字符，新固件可能要求编码严格符合标准规范。
• 核对参数类型：检查type等字段的类型是否与最新API手册完全匹配，例如若手册标注type为字符串类型，需将1改为"1"。
• 检查请求头设置：确保请求头Content-Type严格设置为application/json;charset=UTF-8，避免因编码声明缺失或格式错误触发校验。
• 移除冗余字段：对比新旧版本API手册，移除请求中未在新版本文档里定义的字段，新固件可能不再兼容旧版本的冗余参数。

内容的提问来源于stack exchange，提问作者Umrbek Yusupov