错误码
更新时间：2019-11-24
若请求错误，服务器将返回的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 |
集群超限额 | 可直接提交工单，咨询问题类型请选择人工智能服务； |
| 6 | no permission to access data | 没有接口权限 | 请确认您调用的接口已经被赋权 常见问题是有V3版本权限， 调用的是v2版本接口； |
| 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 or id number not exist |
身份证号码与姓名不匹配， 或无法找到此身份证号码 |
建议提示用户重新核查姓名和身份证号是否输入有误，如确实为作弊情况，可在多次提示后锁住一段时间操作。如用户确定内容正确，则可能在身份查询系统找不到 |
| 216602 | face is blocked | 输入生活照人脸遮挡， 质量检测不通过 |
建议提示用户不要佩戴墨镜、口罩，避免大面积头发遮挡等 |
| 216603 | face light is not good | 人脸光照不好，质量检测不通过 | 建议提示用户不要在光线过强、逆光等情况操作，同时确保脸部光线一般明亮即可 |
| 216604 | face is incomplete | 人脸不完整，质量检测不通过 | 建议提示用户将脸部置于镜头前方，确保脸部都在画面之内 |
| 216605 | 人脸置信度低，质量检测不通过 | - | 建议提示用户检查将人脸置于镜头前方，确保光线正常 |
| 216606 | face is fuzzy | 人脸模糊，质量检测不通过 | 建议提示用户保持镜头稳定，拍摄时不要突然晃动头部 |
| 216607 | police picture is none or low quality |
公安库无此人图片或公安小图 质量不佳 |
对于数据缺失，建议开设人工反馈渠道，进行人工认证处理 |
| 216608 | face liveness check fail | 输入的生活照活体校验不通过 | 建议提示用户确保人脸全部置于画面中，拍摄时不要抖动造成拖影，镜头不要逆光，周边光线不要太强，人脸部分的光线保持正常室内光即可 |
| 216609 | 人脸左右角度过大 | - | 建议提示用户人脸正视屏幕 |
| 216610 | 人脸俯仰角度过大 | - | 建议提示用户人脸正视屏幕 |