错误码
更新时间：2022-10-12
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
例如Access Token失效返回：
{
"error_code": 110,
"error_msg": "Access token invalid or no longer valid"
}上述问题重新获取新的Access Token再次请求即可。
接口流控及鉴权错误码
| 错误码 | 错误信息 | 描述 | 处理建议 |
|---|---|---|---|
| 2 | Service temporarily unavailable | 服务暂不可用 | 可直接提交工单，咨询问题类型请选择人工智能服务； |
| 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[fieldName] is null | 必要参数未传入 | 参考API说明文档，传入必须的fieldName字段 |
| 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 |
身份证号不符合要求，备注：中国大陆身份证号的每一位数字都有其生成规则，不可随意填写。 | 填写正确的身份证号 |
| 222023 | param[name] format error | 参数格式错误 | 请检查手机号、姓名、身份证号格式是否正确 |
| 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张 |
| 222213 | face size is too small | 人脸尺寸过小，请保证人脸区域在64*64以上 | 请重新尝试， 请重新上传符合人脸尺寸要求的图片 |
| 222214 | face are cartoon images | 请使用非卡通的人脸图像 | 请重新尝试， 请重新上传非卡通的人脸图像 |
| 222215 | face quality is not acceptable | 人脸属性编辑处理该图像失败，请使用其他图片 | 请使用其他图片重新上传 |
| 222300 | add face fail | 人脸图片添加失败 | 重新尝试 |
| 222301 | get face fail | 获取人脸图片失败 | 请重新尝试， 如果持续出现此类错误， 请提交工单 |
| 222302 | system error | 服务端请求失败 | 重新尝试 |
| 222303 | get face fail | 获取人脸图片失败 | 请重新尝试， 如果持续出现此类错误，请提交工单 |
| 222309 | image size is too small | 图片尺寸过小，请使用清晰的图片 | 请重新尝试， 请重新上传符合尺寸要求的图片 |
| 222152 | param[target] format error | 人脸属性编辑，target参数错误 | 请修改参数后重试 |
| 222514 | face editattrpro operation fail | 人脸属性编辑v2调用服务失败，请重试 | 请重试 |
| 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永久有效 |
| 223107 | scene_type not same | 人脸库中人脸复制时源组与目标组的scene_type不同 | scene_type不同的组之间用户不能复制 |
| 223110 | uid_list is too large | uid_list包含数量过多 | 请按照文档提示 设置user_list参数 |
| 223111 | dst group 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 | 正在清理该用户组的数据 | 请等该用户组清理完毕后再对 该组进行操作 |
| 223136 | images exist in this group | 该组内存在关联图片，无法新建相同名称组 | 需清理完该组下的数据后才能创建组 |
| 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 | 合成图检测未通过 | 此次活体检测结果为合成图攻击 |
| 223133 | video extract image liveness check fail | 视频提取图片活体检测失败 | 视频可能存在活体攻击 |
| 223052 | action identify fail | 视频中的动作验证未通过 | 请重新录制视频 |
| 223201 | param[scene_type] format error | 请求参数scene_type 格式错误 | 请检查请求参数 |
| 223202 | scene_type does not match | 识别时请求的scene_type与group设置的scene_type不匹配 | 检查请求参数 （此校验默认不开启） |
人脸实名认证系列接口错误码
| 错误码 | 错误信息 | 说明 | 处理建议 |
|---|---|---|---|
| 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 | 视频中的语音与语音验证码所对应数值相似度过低 | 请重新录制视频 |
人脸实名认证方案错误码列表
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 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 | 参数异常，检查入参 |