错误码

更新时间：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	人脸俯仰角度过大	-	建议提示用户人脸正视屏幕

H5活体检测

REST API SDK-v2