文档首页 > > API参考> 附录> 错误码

错误码

分享
更新时间: 2020/01/16 GMT+08:00

调用API出错后,将不会返回结果数据。调用方可根据每个API对应的错误码来定位错误原因。当调用出错时,HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系客服,并提供错误码,以便我们尽快帮您解决问题。

  • 异常响应样例
    { 
       "error_code": "FRS.0202", 
       "error_msg": " The service has been freeze."
     }
  • 参数说明

    参数

    是否必选

    类型

    说明

    error_code

    String

    错误码。

    error_msg

    String

    错误消息。

  • 错误码说明

    错误码类别

    状态码

    错误码

    说明

    服务类公共错误

    (错误码区间:1~99)

    403

    FRS.0002

    鉴权token失败。

    400

    FRS.0010

    缺少请求头或者请求头为空。

    400

    FRS.0011

    缺少参数。

    400

    FRS.0012

    请求参数格式不正确。

    400

    FRS.0014

    输入的不是json格式。

    400

    FRS.0015

    图片base64解析错误。

    400

    FRS.0016

    上传的文件格式不支持。

    400

    FRS.0017

    上传的body体超出允许的范围。

    500

    FRS.0018

    服务内部错误。

    400

    FRS.0019

    服务未开通。

    400

    FRS.0020

    子服务未开通。

    400

    FRS.0021

    无效OBS的url。

    400

    FRS.0022

    获取OBS文件失败。

    400

    FRS.0023

    OBS上的文件大小超出范围。

    400

    FRS.0024

    OBS上的文件不存在。

    400

    FRS.0027

    OBS未授权。

    403

    FRS.0028

    Project ID跟token不匹配。

    400

    FRS.0029

    过滤格式错误。

    400

    FRS.0030

    返回字段未定义。

    400

    FRS.0031

    排序字段不在返回字段中。

    400

    FRS.0032

    排序字段以及类型不支持,只支持数字类型。

    服务管理错误

    (错误码区间:201~300)

    400

    FRS.0201

    此用户已经注册了。

    400

    FRS.0202

    服务已经被冻结。

    400

    FRS.0203

    更新用户信息失败。

    人脸库资源错误

    (错误码区间:301~400)

    400

    FRS.0301

    无法创建已经存在的人脸库。

    400

    FRS.0302

    人脸库不存在。

    400

    FRS.0304

    未检测到人脸,无法搜索。

    400

    FRS.0305

    超过最大的人脸库数量,无法创建新的人脸库。

    403

    FRS.0306

    超过人脸库容量限制,无法增加更多的人脸。

    人脸资源错误

    (错误码区间:401~500)

    400

    FRS.0401

    找不到对应类型的值,无法删除。

    400

    FRS.0402

    输入的字段不存在。

    400

    FRS.0403

    Face ID不存在。

    400

    FRS.0404

    未检测到人脸,无法添加。

    400

    FRS.0405

    未定义的自定义字段,无法添加。

    400

    FRS.0406

    导入的数据类型与定义不匹配。

    400

    FRS.0407

    批量删除未找到匹配数据。

    人脸比对错误

    (错误码区间:501~600)

    400

    FRS.0501

    照片未检测到人脸。

    活体检测错误

    (错误码区间:701~800)

    400

    FRS.0701

    视频解析错误。

    400

    FRS.0702

    不支持的动作。

    400

    FRS.0703

    Action time非法。

    400

    FRS.0704

    传入的action数量超过10个。

    400

    FRS.0705

    匹配模式不支持。

    400

    FRS.0706

    视频时长不支持,限制[1-15]秒。

    人脸标签检索错误码

    (错误码区间:100~200)

    400

    FRS.0100

    检查参数是否合法,例如是否为空。

    403

    FRS.0102

    检查输入的日期格式是否正确。

    403

    FRS.0103

    检查输入的人脸图片质量是否满足要求。

    403

    FRS.0104

    检查输入的人脸是否重复。

    404

    FRS.0105

    检查face_label_id参数是否正确。

    403

    FRS.0106

    单个人脸集内成员正脸照片的数量已经超出了限制,请检查成员的数量。

    系统默认单个人脸集内最多10张成员的正脸照片,如果您需要更高规模的,请联系客服提供支持。

    403

    FRS.0107

    单个人脸集内辅助脸照片的数量已经超出了限制,请检查辅助人脸的数量。

    系统默认单个人脸集内最多50张辅助脸照片,如果您需要更高规模的,请联系客服提供支持。

    400

    FRS.0108

    检查输入的obs桶名和参数是否正确,是否开通了委托服务。

    400

    FRS.0109

    检查输入的face_set_name参数的长度,长度不能超过24个字节。

    400

    FRS.0110

    检查输入的face_set_name参数是否包含非法字符,该参数中只能包括英文大小写字母、数字、下划线(_)或中划线(-)的组合。

    400

    FRS.0111

    不符合OBS的路径规范,检查输入的face_obskey参数是否合法:不能以“/”作为初始字符,路径必须包含一层目录。例如“pictures/face001.jpg”

    400

    FRS.0112

    检查输入的face_obskey标识的图片格式,目前只支持JPG、PNG、JPEG、BMP格式的图片。

    400

    FRS.0113

    检查face_obskey的路径规范,是否满足包含人脸集的要求。如无法满足,可以考虑在端侧上报人脸图片接口中携带face_set_name参数。

    400

    FRS.0114

    检查face_date是否为当天时间的日期。

    400

    FRS.0115

    检查query_date是否超过了当天的时间。

    400

    FRS.0116

    检查query_date的年份是否正确,应该跟当天的年份相同。

    400

    FRS.0117

    检查query_date是否满足格式要求。

    403

    FRS.0118

    检查query_date是否超过了30天内的期限。

    403

    FRS.0119

    检查图片大小是否超过了8M的限制。

    403

    FRS.0120

    系统繁忙,请检查调用是否过频繁,如果业务请求增加,请联系华为客服寻求业务扩容支持。

    403

    FRS.0121

    检查图片中人脸姿态角度是否满足要求。

    403

    FRS.0122

    检查face_obskey是否同时出现在多个请求中。

    403

    FRS.0123

    检查是否同时删除同一个face_label_id。

    404

    FRS.0124

    添加成员辅助脸的单个请求消息中,face_obskey参数的List里面包含的图片数量不能超过10张,请分为多个请求消息添加。

  • 网关错误码

    错误码类别

    状态码

    错误码

    说明

    网关类错误

    (错误码区间:1~400)

    404

    APIG.0101

    API不存在。

    413/504

    APIG.0201

    请求体超过范围或者后端超时。

    401

    APIG.0301

    鉴权失败。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区