人脸识别

    错误码

    若请求错误,服务器将返回的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 人脸俯仰角度过大 - 建议提示用户人脸正视屏幕
    上一篇
    H5活体检测
    下一篇
    REST API SDK-v2