废弃(2009)-支持文档
[TOC]
##易源的错误码
目前我们将统一使用JSON作为返回信息的数据格式，如下图所示
在上图中的JSON中**showapi_res_body**字段对应的JSON是连接器所接接口返回的原始信息，其他字段，如**showapi_res_code**是易源平台在鉴权时返回的错误码，具体信息如下图：
在这里我们叫他**系统级参数**
当您的请求在我们平台就发生错误时，我们就会通过**系统级参数**向您返回错误信息
若您的请求已被我们的连接器转发到连接的目标，如转发到**百度智能云**这是返回的错误码便是**百度智能云**返回的错误码，这时的错误码将出现在**showapi_res_body**的JSON中，如下图：
##通用及业务错误码
|错误码|错误信息|说明|处理建议
|-
|222001|param[] is null|必要参数未传入|参考API说明文档，修改参数
|222002|param[start] formaterror|参数格式错误|参考API说明文档，修改参数
|222003|param[length] formaterror|参数格式错误|参考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 formaterror|参数格式错误|参考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] formaterror|参数格式错误|参考API说明文档，修改参数
|222014|param[app_id] formaterror|参数格式错误|参考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说明文档，修改参数
|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 notfound|未找到匹配的用户|请确认人脸库中是否存在此用户
|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以下下
|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度）|请使用面向正前方的人脸图片
##公安验证接口错误码
|错误码|错误信息|说明|处理建议
|-
|222350|police picture is none orlow 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|视频中的声音无法识别（声音过低或者有杂音导致无法识别）|请重新录制视频
|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说明文档，修改参数