华为云首页用户手册

人证核身服务 IVS-错误码:错误码说明

人证核身服务 IVS-错误码:错误码说明

时间：2023-11-17 18:30:27

人证核身服务 IVS 附录

错误码说明

表1 错误码
状态码	错误码	错误信息	说明	处理措施
400	IVS.0001	Request parameter meta is null or empty.	请求体参数为null或空。	请参考API文档填写请求Body信息，并检查请求body格式是否正确。
400	IVS.0002	Request parameter req_data is redundant.	请求体参数冗余，req_data的元素数量大于1。	req_data列表中当前仅支持1个元素。
400	IVS.0003	Some necessary request parameters in req_data is null.	请求参数有一些必要的参数为null。	请参考API文档填写必要的参数后重试。
400	IVS.0004	Image base64 size is more than 4MB or less than 10KB.	图像的base64数据量大于4MB或小于10KB。	要求base64编码后大小不超过4MB。图像各边的像素大小在300到8000px之间。
400	IVS.0005	Video base 64 size is more than 10MB or less than 10KB.	视频的base 64数据量大于10MB或小于10KB。	要求base 64编码后大小不超过10MB。建议客户端压缩至200KB至2MB。
400	IVS.0006	The input face image is invalid.	输入的人脸图像不合法。	要求base64编码后大小不超过4MB。图像各边的像素大小在300到4000px之间，支持JPG格式。
400	IVS.0007	Id card image error: %s. Please try another image.	输入的身份证图像错误，请换张图像重试。	请检查身份证图片是否正常，图片中文字清晰，并根据具体错误信息更换图片。
400	IVS.0008	live detect error: %s. Please check your input.	活体检测失败，请检查输入。	请检查视频是否正常，视频中的人的头部和脸部符合动作要求，并根据具体错误信息更换视频或修改动作列表。
400	IVS.0009	face detect error: %s. Please check your input.	人脸检测失败，请检查输入。	请检查人脸图片是否正常，图片中有清晰的人脸，并根据具体错误信息更换图片。
400	IVS.0010	face compare error: %s. Please check your input.	人脸比对失败，请检查输入。	请检查输入图片base64中是否包含人脸。
400	IVS.0011	The request param has wrong format, the length of %s exceeds %s bytes. The request param has wrong format, error in parsing %s, %s type expected. The request param has wrong format, %s is null or empty. The request param has wrong format, verification_name contain invalid characters. The request param has wrong format, verification_id length must equal 15 or 18. The request param has wrong format, verification_id is invalid.	请求参数格式错误，参数长度超出范围。请求参数格式错误，解析参数出现错误。请求参数格式错误，参数的值为null或空。请求参数格式错误，verification_name 包含了无效字符。请求参数格式错误，verification_id长度需为15位或18位。请求参数格式错误，verification_id无效。	请将参数长度设置在相应范围内。请参考API文档，修改对应参数的类型。请检查参数名是否填写正确，以及参数名对应的值是否有填写。请检查verification_name是否为有效的姓名。请检查verification_id的长度。请检查verification_id是否为有效的身份证号码。
400	IVS.0012	Lack Header or Header Content-Type is empty.	缺少请求头或请求头为空。	请参考API文档填写请求头。
400	IVS.0013	The authentication token is abnormal.	Token异常。	请参考认证鉴权重新获取Token。
400	IVS.0014	The service has been frozen.	服务已冻结。	请检查是否有欠费。
400	IVS.0015	The subservice has not been subscribed.	服务未开通。	请登录控制台开通人证核身服务。已开通情况下，检查服务的开通区域和调用API时，url中填写的区域是否一致。
500	IVS.0101	Service inner error.	服务内部错误。	请联系华为云支持人员。

网关错误码

错误码类别	状态码	错误码	说明	处理措施
网关类错误（错误码区间：1～400）	404	APIG.0101	访问的API不存在或尚未在环境中发布。	请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。检查URI中的区域信息是否和调用服务配置的区域是否对应。 HTTP请求方法（POST，GET等）是否正确。具体的URI信息请在各接口的API页面查看。
	413/504	APIG.0201	请求体超过范围或者后端超时。	请检查请求的大小是否合法，请联系客服检查后端服务是否运行正常。
	401	APIG.0301	IAM身份验证信息不正确： decrypt token fail：token解析失败。 token expires：token过期。 verify aksk signature fail：AK/SK认证失败。	token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 token超时（token expires），请重新获取token，使用不过期的token。请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。检查帐号权限，是否欠费，被冻结等。
	401	APIG.0307	Token需要更新	Token有效期为24小时，请使用重新获取Token调用API。检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。

当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。

上一篇：语音交互服务 SIS-调用API实现一句话识别:步骤2：Token认证

下一篇：云日志服务 LTS-结构化模板:自定义模板

人证核身服务 IVS-错误码:错误码说明

意见反馈

0/200

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

推荐文章

解决方案
相关专题