错误码
所有文档

          人脸识别

          错误码

          若请求错误,服务器将返回的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天有效期
          上一篇
          常见问题及排查
          下一篇
          SDK文档