错误码
更新时间:2020-12-15
若请求错误,服务器将返回的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 |
通用及业务错误码
错误码 | 错误信息 | 说明 | 处理建议 |
---|---|---|---|
222001 | param[] is null | 必要参数未传入 | 参考API说明文档,修改参数 |
222002 | param[start] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222003 | param[length] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222004 | param[op_app_id_list] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222005 | param[group_id_list] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222006 | group_id format error | 参数格式错误 | 参考API说明文档,修改参数 |
222007 | uid format error | 参数格式错误 | 参考API说明文档,修改参数 |
222008 | face_id format error | 参数格式错误 | 参考API说明文档,修改参数 |
222009 | quality_conf format error |
参数格式错误 | 参考API说明文档,修改参数 |
222010 | user_info format error | 参数格式错误 | 参考API说明文档,修改参数 |
222011 | param[uid_list] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222012 | param[op_app_id] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222013 | param[image] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222014 | param[app_id] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222015 | param[image_type] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222016 | param[max_face_num] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222017 | param[face_field] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222018 | param[user_id] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222019 | param[quality_control] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222020 | param[liveness_control] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222021 | param[max_user_num] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222022 | param[id_card_number] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222023 | param[name] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222024 | param[face_type] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222025 | param[face_token] format error |
参数格式错误 | 参考API说明文档,修改参数 |
222026 | param[max_star_num] format error | 参数格式错误 | 参考API说明文档,修改参数 |
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说明文档,修改参数 |
222039 | param[face_sort_type] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222200 | request body should be json format | 该接口需使用 application/json的 格式进行请求 |
请修改接口格式为: application/json |
222201 | network not available | 服务端请求失败 | 重新尝试 |
222202 | pic not has face | 图片中没有人脸 | 检查图片质量 |
222203 | image check fail | 无法解析人脸 | 检查图片质量 |
222204 | image_url_download_fail | 从图片的url下载 图片失败 |
请确认url可公网访问 |
222205 | network not availablel | 服务端请求失败 | 重新尝试 |
222206 | rtse service return fail | 服务端请求失败 | 重新尝试 |
222207 | match user is not found |
未找到匹配的用户 | 请确认人脸库中 是否存在此用户 |
222208 | the number of image is incorrect |
图片的数量错误 | 多张图片请使用 json格式传输 |
222209 | face token not exist | face token不存在 | 请确认您操作的 人脸已创建成功; 若face_token未注册到 人脸库则有效期只有1小时 注册人脸库的 face_token永久有效 |
222210 | the number of user's faces is beyond the limit | 人脸库中用户下的人脸数目超过限制 | 当前每个用户下限制人脸数目最大20张 |
222300 | add face fail | 人脸图片添加失败 | 重新尝试 |
222301 | get face fail | 获取人脸图片失败 | 请重新尝试, 如果持续出现此类错误, 请提交工单 |
222302 | system error | 服务端请求失败 | 重新尝试 |
222303 | get face fail | 获取人脸图片失败 | 请重新尝试, 如果持续出现此类错误,请提交工单 |
223100 | group is not exist | 操作的用户组不存在 | 请确认您操作的 用户组已创建成功 |
223101 | group is already exist | 该用户组已存在 | 请不要重复创建用户组 |
223102 | user is already exist | 该用户已存在 | 请不要重复创建用户 |
223103 | user is not exist | 找不到该用户 | 请确认您操作的 用户已创建成功 |
223104 | group_list is too large | group_list包含组 数量过多 |
请按照文档提示 设置group_list参数 |
223105 | face is already exist | 该人脸已存在 | 请不要重复添加人脸 |
223106 | face is not exist | 该人脸不存在 | 请确认您操作的 人脸已创建成功; 若face_token未注册到 人脸库则有效期只有1小时, 注册人脸库的 face_token永久有效 |
223110 | uid_list is too large | uid_list包含数量过多 | 请按照文档提示 设置user_list参数 |
223111 | dst group is not exist | 目标用户组不存在 | 请确认您操作的 用户组已创建成功 |
223112 | quality_conf format error |
quality_conf格式不正确 | 请按照文档提示设置 quality_conf参数 |
223113 | face is covered | 人脸有被遮挡 | 提示用户请勿遮挡面部 |
223114 | face is fuzzy | 人脸模糊 | 人脸图片模糊, 前端页面可以提示 用户拍摄时不要晃动手机 |
223115 | face light is not good | 人脸光照不好 | 提示用户到光线适宜的地方拍摄 |
223116 | incomplete face | 人脸不完整 | 提示用户请勿遮挡面部 |
223117 | app_list is too large | app_list包含app数量 过多 |
请按照文档提示设置 app_list参数 |
223118 | quality control error | 质量控制项错误 | 请按照文档提示设置 质量控制参数 |
223119 | liveness control item error |
活体控制项错误 | 请按照文档提示设置 活体控制参数 |
223120 | liveness check fail | 活体检测未通过 | 此次活体检测结果为非活体 |
223121 | left eye is occlusion | 质量检测未通过 左眼 遮挡程度过高 |
提示用户请勿遮挡左眼 |
223122 | right eye is occlusion | 质量检测未通过 右眼 遮挡程度过高 |
提示用户请勿遮挡右眼 |
223123 | left cheek is occlusion | 质量检测未通过 左脸 遮挡程度过高 |
提示用户请勿遮挡左脸颊 |
223124 | right cheek is occlusion |
质量检测未通过 右脸 遮挡程度过高 |
提示用户请勿遮挡右脸颊 |
223125 | chin contour is occlusion |
质量检测未通过 下巴遮挡程度过高 | 提示用户请勿遮挡下巴 |
223126 | nose is occlusion | 质量检测未通过 鼻子遮挡程度过高 | 提示用户请勿遮挡鼻子 |
223127 | mouth is occlusion | 质量检测未通过 嘴巴 遮挡程度过高 |
提示用户请勿遮挡嘴巴 |
222901 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222902 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222903 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222904 | system busy | 参数校验初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222905 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222906 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222907 | system busy | 缓存处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222908 | system busy | 缓存处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222909 | system busy | 缓存处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222910 | system busy | 数据存储处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222911 | system busy | 数据存储处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222912 | system busy | 数据存储处理失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222913 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222914 | system busy | 接口初始化失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222915 | system busy | 后端服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222916 | system busy | 后端服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222304 | image size is too large | 图片尺寸太大 | 请确保图片尺寸在1920x1080以下下 |
222305 | pic storage not support | 当前版本不支持图片存储 | 请确认face_token的使用符合规范 |
223128 | group was deleting | 正在清理该用户组的数据 | 请等该用户组清理完毕后再对 该组进行操作 |
222361 | system busy | 公安服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
222046 | param[template_type] format error | 参数格式错误 | 请参考接口文档修改 |
222101 | param[merge_degree] format error | 参数格式错误 | 请参考API说明文档,修改参数 |
222102 | param[face_location] format error | 参数格式错误 | 参考API说明文档,修改参数 |
222307 | image illegal, reason: porn | 图片非法 鉴黄未通过 | 请重新上传合法的图片 |
222308 | image illegal, reason: sensitive person | 图片非法 含有政治敏感人物 | 请重新上传合法的图片 |
222211 | template image quality reject | 人脸融合失败 模板图质量不合格 | 请检查模板图是否符合 人脸融合文档中的质量要求 |
222212 | merge face fail | 人脸融合失败 | 请更换素材后重新尝试, 如果持续出现此类错误,请提交工单 |
223129 | face not forward | 人脸未面向正前方 (人脸的角度信息大于30度) |
请使用面向正前方的人脸图片 |
223130 | spoofing_control item error | spoofing_control参数格式错误 | 请求参数spoofing_control的值不是接口文档指定的[‘NONE’, ‘LOW’, ‘NORMAL’, ‘HIGH’] 其中之一,修改请求参数 spoofing_control 值 |
223131 | spoofing check fail | 合成图检测未通过 | 此次活体检测结果为合成图攻击 |
人脸实名认证接口错误码
错误码 | 错误信息 | 说明 | 处理建议 |
---|---|---|---|
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 | police picture not exist | 身份证号码正确,公安库里没有 对应的照片 |
对于公安数据缺失, 建议开设人工反馈 渠道,进行人工认证处理 |
222356 | person picture is low quality | 验证的人脸图片质量不符合要求 | 确认图片上的 人脸是否清晰, 不能有多张人脸, 图片大小不能超过600KB |
222360 | invalid name or id number | 身份证号码或名字非法 (公安网校 验不通过) |
可能身份证号码或 姓名填写错误, 请用户再次确认。 可能为作弊用户, 请增加审批环节 |
222361 | network not available | 公安服务连接失败 | 请重新尝试, 若尝试多次无效, 请提交工单咨询 |
216600 | id number format error | 输入身份证格式错误 | 请检查后重新输入 |
216601 | id number and name not match | 身份证号和名字匹配失败 | 请检查后重新输入 |
H5活体检测接口错误码列表
错误码 | error_msg | 错误信息 | 描述 |
---|---|---|---|
216430 | rtse/face service error | rtse/face 服务异常 | 请重新尝试 |
216431 | voice service error | 语音识别服务异常 | 请重新尝试 |
216432 | video service call fail | 视频解析服务调用失败 | 请重新尝试 |
216433 | video service error | 视频解析服务发生错误 | 请重新尝试 |
216434 | liveness check fail | 活体检测失败 | 请重新尝试 |
216500 | code digit error | 验证码位数错误 | 验证码错误, 请增加一层验证环节 |
216501 | not found face | 没有找到人脸 | 请查看上传视频是否包含人脸 |
216502 | session lapse | 当前会话已失效 | 请重新获取语音验证码 |
216505 | redis connect error | redis连接失败 | 请重新尝试 |
216506 | redis operation error | redis操作失败 | 请重新尝试 |
216507 | found many faces | 视频中有多张人脸 | 请重新录制视频 |
216508 | not found video info | 没有找到视频信息 | 请参考文档修改视频格式 |
216509 | voice can not identify | 视频中的声音无法识别 (声音过低或者有杂 音导致无法识别) |
请重新录制视频 |
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说明文档,修改参数 |
实名认证系统错误码列表
错误码 | error_msg | 错误信息 | 描述 |
---|---|---|---|
283421 | App not exist | 应用不存在 | 传入不存在的app |
283435 | Plan not exist | 方案不存在 | 请到方案管理页面确认填写方案ID是否正确 |
283436 | Verify token generate failed | Token生成失败,请重试 | 请重新尝试 |
283437 | Verify token invalid or expired | Token无效或已过期,请重新生成 | 请重新尝试 Token有效期为2小时,使用后失效 |
283451 | Verification is running | 认证处理中 | 请重新尝试 |
283455 | Result is expired | 超出查询有效期 | 超过3天有效期 |