错误码
调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
错误响应Body体格式说明
当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。
{
"error_code": "IVS.0003",
"error_msg": "Some necessary request parameters in req_data is null."
}
其中，error_code表示错误码，error_msg表示错误描述信息。
错误码说明
状态码 |
错误码 |
错误信息 |
说明 |
处理措施 |
|---|---|---|---|---|
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 |
|
|
|
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. |
服务未开通。 |
|
500 |
IVS.0101 |
Service inner error. |
服务内部错误。 |
当您调用API时，如果遇到“APIGW”,“APIG”开头的错误码，请参见API网关错误码进行处理。
