错误码

若请求错误,服务器将返回的JSON文本包含以下参数:

  • error_code:错误码。

  • error_msg:错误描述信息,帮助理解和解决发生的错误。

例如Access Token失效返回:

{
  "error_code": 110,
  "error_msg": "Access token invalid or no longer valid"
}

上述问题重新获取新的Access Token再次请求即可。

接口流控及鉴权错误码

错误码 错误信息 描述 处理建议
4 Open api request limit reached 集群超限额 可直接提交工单,咨询问题类型请选择人工智能服务
17 Open api daily request limit reached 每天流量超限额 提交工单,咨询问题类型请选择人工智能服务
18 Open api qps request limit reached QPS超限额 可直接自助购买更多QPS、联系商务接口人、或者提交工单,咨询问题类型请选择人工智能服务
19 Open api total request limit reached 请求总量超限额 提交工单,咨询问题类型请选择人工智能服务
100 Invalid parameter 无效的access_token参数 token拉取失败,可以参考“Access Token获取”重新获取
110 Access token invalid or no longer valid Access Token失效 token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token
111 Access token expired Access token过期 token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token

通用及业务错误码

错误码 错误信息 描述 处理建议
216100 invalid param 参数异常,具体异常原因详见error_msg 根据msg信息具体排查
216101 not enough param 缺少必须的参数,具体异常原因详见error_msg 检查入参中必选参数是否都填写
216102 service not support 请求了不支持的服务 请检查调用的url
216103 param too long 请求超长 一般为一次传入图片个数超过系统限制
216110 appid not exist appid不存在 请重新检查后台应用列表中的应用信息
216111 invalid userid userid信息非法 请检查对应的参数
216200 empty image 图片为空或者base64解码错误 检查base64编码是否正确,base64后是否做了urlencode
216201 image format error 图片格式错误 检查base64编码是否正确,base64后是否做了urlencode
216202 image size error 图片大小错误 检查图片大小是否符合要求,注意图片大小是指base64编码后的大小
216300 db error 数据库异常 少量发生时重试即可
216400 backend error 后端识别服务异常 可以根据具体msg查看错误原因
216402 face not found 未找到人脸 请检查图片是否含有人脸
216500 unknown error 未知错误 少量发生时重试即可
216611 user not exist 用户不存在 请确认该用户是否注册或注册已经生效,注册到生效的最长延时为5s
216613 fail to delete user record 删除用户图片记录失败 重试即可
216614 not enough images 两两比对中图片数少于2张,无法比较 检查传入的图片数量
216615 fail to process images 服务处理该图片失败 重试即可
216616 image existed 图片已存在 无需重复注册
216617 fail to add user 新增用户图片失败 重试,或检查图片是否编码正确
216618 no user in group 组内用户为空 确认该group是否存在或已经生效
216631 request add user overlimit 本次请求添加的用户数量超限 检查注册的uid数量

公安验证接口错误码

错误码 错误信息 描述 处理建议
216501 face not found 传入的生活照中没有找到人脸 建议提示用户重新操作,确保人脸置于镜头前方
216600 id number format error 身份证格式错误,请检查后重新输入 建议提示用户重新仔细检查身份证号中的数字及字母信息
216601 id number and name not match 身份证号与姓名匹配失败 建议提示用户重新核查姓名和身份证号是否输入有误,如确实为作弊情况,可在多次提示后锁住一段时间操作
216602 人脸被遮挡了,质量检测不通过 - 建议提示用户不要佩戴墨镜、口罩,避免大面积头发遮挡等
216603 人脸光照不好,质量检测不通过 - 建议提示用户不要在光线过强、逆光等情况操作,同时确保脸部光线一般明亮即可
216604 人脸不完整,质量检测不通过 - 建议提示用户将脸部置于镜头前方,确保脸部都在画面之内
216605 人脸置信度低,质量检测不通过 - 建议提示用户检查将人脸置于镜头前方,确保光线正常
216606 人脸模糊,质量检测不通过 - 建议提示用户保持镜头稳定,拍摄时不要突然晃动头部
216607 身份证信息匹配失败 公安库无此人图片或公安小图质量不佳 对于数据缺失,建议开设人工反馈渠道,进行人工认证处理
216608 人脸活体校验不通过 输入的生活照活体校验不通过 建议提示用户确保人脸全部置于画面中,拍摄时不要抖动造成拖影,镜头不要逆光,周边光线不要太强,人脸部分的光线保持正常室内光即可
216609 人脸左右角度过大 - 建议提示用户人脸正视屏幕
216610 人脸俯仰角度过大 - 建议提示用户人脸正视屏幕