错误码
更新时间：2022-10-12
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
通用错误码信息可查看：https://ai.baidu.com/ai-doc/FACE/5k37c1ujz
人脸实名认证方案错误码列表
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 283458 | 当前链接已失效，请重试 | 请检查是否为token不存在，或token已过期，token状态不对(核验成功后不能通过该token再次核验 或者 在方案里配置了『核验失败且只能验证一次』) |
| 283437 | Token无效或已过期，请重新生成 | token已过期 或者 token状态不对(同上) |
| 283450 | 认证尚未开始。Verification is not started yet | 用户还未进行核验，token状态必须是失败、成功、核验中 |
| 283451 | 认证处理中。Verification is running | token状态是核验中，请等一会再操作 |
| 283455 | 超出查询有效期。Result is expired | token过期，查询结果失败 |
| 283400 | 服务异常，请稍后再试 | 服务异常，可能原因：参数错误、查询结果不存在、处理失败等。多次操作依旧报错请联系管理员 |
| 283458 | 视频文件上传 bos 失败 | 多次操作依旧报错请联系管理员 |
| 283439 | STS_Token 已经生成 | STS临时token已经生成，等待过期后再操作(默认30s) |
| 283460 | 视频文件过大，核验请求超时 | 修改上传的视频文件 |
| 283437 | 对比源信息未传入 | 上传比对图片 |
| 283449 | 活体检测视频不符合要求，请重新上传 | 视频文件太大、太小、为空 |
| 100 | Invalid parameter | 参数异常，检查入参 |
人脸实名认证系列接口错误码
| 错误码 | 错误信息 | 说明 | 处理建议 |
|---|---|---|---|
| 222350 | police picture is none or low quality |
公安网图片不存在或 质量过低 |
此用户的信息没有 被公安数据覆盖到， 请将此次身份验证 转到人工进行处理 |
| 222351 | id number and name not match or id number not exist |
身份证号与姓名不匹配 | 可能身份证号码或 姓名填写错误， 请用户再次确认。 可能为作弊用户， 请增加审批环节 |
| 222352 | name format error | 名字格式错误 | 姓名格式错误， 请确认用户姓名 是否输入正确 |
| 222353 | id number format error | 身份证号码格式错误 | 身份证号码格式错误， 请确认用户身份证号码 是否输入正确 |
| 222354 | id number not exist | 公安库里不存在此身份证号 | 对于公安数据缺失， 建议开设人工反馈渠道， 进行人工认证处理 |
| 222355 | ipolice picture not exist | 身份证号码正确，公安库里没有对应的照片 | 对于公安数据缺失， 建议开设人工反馈渠道， 进行人工认证处理 |
| 222356 | person picture is low quality | 验证的人脸图片质量不符合要求 | 确认图片上的人脸是否清晰 不能有多张人脸 图片大小不能超过600KB 请重新拍摄 |
| 222361 | network not available | 公安服务连接失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 282105 | image decrypt error | 图片解密失败 | 请重新尝试，确认下载SDK的appid与服务端请求appid是否一致 若尝试多次无效，请提交工单咨询 |
| 216201 | image format error | 图片格式失败 | 请检查传入的图片base64格式是否有误； 如您使用人脸离线采集SDK，可能为加密错误导致，请检查SDK文件 |
| 216100 | invalid param | 参数格式失败 | 请检查入参格式 |
| 282003 | missing required parameter（s) | 缺少必要参数 | 请检查入参是否完整 |
| 282000 | internal error | 服务器内部错误 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222041 | param[start_date] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222042 | param[end_date] format error | 参数格式错误 | 参考API说明文档，修改参数 |
H5活体检测接口错误码列表
| 错误码 | error_msg | 错误信息 | 描述 |
|---|---|---|---|
| 216430 | rtse/face service error | rtse/face 服务异常 | 请重新尝试 |
| 216431 | voice service error | 语音识别服务异常 | 请重新尝试 |
| 216432 | video service call fail | 视频解析服务调用失败 | 请重新尝试 |
| 216433 | video service error | 视频解析服务发生错误 | 请重新尝试，确认是否选择语音验证码但未上传音频，或语音验证码读取不正确 |
| 216500 | code digit error | 验证码位数错误 | 验证码错误， 请增加一层验证环节 |
| 216501 | not found face | 没有找到人脸 | 请查看上传视频是否包含人脸 |
| 216502 | session lapse | 当前会话已失效 | 请重新获取语音验证码 |
| 216505 | redis connect error | redis连接失败 | 请重新尝试 |
| 216506 | redis operation error | redis操作失败 | 请重新尝试 |
| 216508 | not found video info | 没有找到视频信息 | 请参考文档修改视频格式 |
| 216509 | voice can not identify | 视频中的声音无法识别 （声音过低或者有杂 音导致无法识别） |
请重新录制视频 |
| 216510 | video time is too long | 动作活体模式验证时视频长度超过10s | 请重新录制时长小于10s的视频 |
| 216511 | voice file error | 语音文件不符合要求 | 请重新录制视频 |
| 216512 | action verify must post session_id | 使用动作活体验证时必须使用会话id | 先调用验证码下发接口获取动作类型的验证码 |
| 216513 | detect_model param error | 检测模型参数错误 | 根据接口文档要求传递参数 |
| 216612 | system busy | 系统繁忙 | 请重新尝试，若多次尝试无效请提交工单解决 |
| 216908 | 视频中人脸质量较差 (返回信息中包含具体原因) |
视频中人脸质量过低 (返回的错误信息会包含 具体的错误信息包含 illumiantion(光照不足) angle(角度不好) blur (人脸模糊) occlusion(有遮挡) too large(人脸过大, 占屏幕2/3以上) 等原因 |
请重新录制视频 |
| 222027 | code length param error | 验证码长度错误 (最小值大于最大值) |
参考API说明文档，修改参数 |
| 222028 | param[min_code_length] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222029 | param[max_code_length] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222030 | param[match_threshold] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 223050 | voice similarity low error | 视频中的语音与语音验证码所对应数值相似度过低 | 请重新录制视频 |