当API请求发生错误时，服务端会返回错误信息。本文档为您介绍API返回的错误码信息。

问题诊断中心

使用问题诊断中心可帮助开发者更高效地诊断API使用过程中的问题。

文字识别错误码

状态码 错误码 描述
400 InvalidImage.Category 输入图像与当前服务不符，如行驶证服务输入的图像不是行驶证。
400 InvalidImage.Content 输入图像内容不合法。 例如：
  • 无效的base64编码图像。
  • 输入的image是空字符串。
  • 无效的image content。
400 InvalidImage.Decode 图像解码失败。输入的image不是合法的base64字符串。
  • 请删除base64字符串多余的头： data:image/jpg:base64。
  • base64编码的数据长度必须是4的倍数，如果长度不够，需要在末尾加上=补齐。
  • 输入的image不是合法的base64字符串，存在非法字符。
400 InvalidImage.Download URL下载图像失败。
400 InvalidImage.Gif GIF图像打开失败、读取失败、解码失败、获取颜色映射表错误、图像为空。
400 InvalidImage.URL 无效的图片URL。
400 InvalidImage.Unsafe URL不安全。
400 IllegalUrlParameter URL不合法。
400 MissingImageURL 缺少图像URL参数。
400 InvalidSide 参数Side无效。
400 Throttling.User 您这个时段的流量已经超限。如果不能满足现有业务要求可以提工单申请。
400 InvalidParameter 参数值校验不通过。请使用请求参数构造规范化的请求字符串。详细信息请参见请求签名。
400 InvalidImage.Region 图片所在地域错误。
400 InvalidResult OCR识别失败、OCR识别异常。
400 InvalidTimeStamp.Expired 用户时间和服务器时间差异超过15分钟，请检查您的时间戳设置，确保用户时间和服务器时间的差值在15分钟内。
400 InvalidParameter.TooLarge 待检测内容过大，请确保待检测内容在API的限制范围内。
400 InvalidOutputFormat 无效的输出格式。
400 MissingOutputFormat 缺少输出格式。
400 InvalidImageType 无效的图片类型。
400 MissingUseFinanceModel 缺少UseFinanceModel参数信息。
400 MissingAssureDirection 缺少AssureDirection参数信息。
400 MissingSide 缺少Side信息。
400 MissingSkipDetection 缺少SkipDetection参数。
400 MissingMinHeight 缺少MinHeight参数。
400 MissingAccessKeyId 缺少AccessKeyId信息。具体请参见创建AccessKey。
400 SignatureNonceUsed SignatureNonce重复。每次请求的SignatureNonce在15分钟内不能重复。
400 SignatureDoesNotMatch 签名不匹配。请检查AccessKeyID和AccessKeySecret是否正确；检查签名方法是否正确。关于签名的详细信息请参见请求签名。
403 Unauthorized 请求权限不够，请为账号授权。
403 ParameterError 参数错误，请检查参数值。
403 UnsupportedHTTPMethod HTTP请求方法不支持。
403 InvalidApi.NotPurchase 服务未开通，请先开通服务。具体请参见能力开通。
404 InvalidAccessKeyId.NotFound AccessKeyID不存在。请检查调用时是否使用了正确的AccessKey。具体请参见创建AccessKey。
408 Timeout 请求超时。
415 InvalidImage.UnsupportedMediaType 输入的image解码失败。
500 InternalError 内部异常。
503 ServiceUnavailable 服务不可用。

公共错误码

API的公共错误码请参见API错误中心。

处理建议

请求服务出现错误码提示，请参见错误码描述查看具体错误原因，并进行错误处理。针对一些常见高频的错误类型，此处提供一些错误处理建议供您参考。
  • URL类错误码

    此类错误码一般都是文件URL不符合要求，例如URL不安全、无效。建议确认当前URL是否正确，或者您可以重新生成URL，具体请参见生成URL。

  • 图像加载错误码

    此类错误也可以看做是图像URL错误，例如图像下载错误、地域错误。当前系统仅支持华东2（上海）地域，如果您通过OSS生成URL，那么您在OSS上创建的Bucket所属地域应该为华东2（上海）。

  • 参数类错误码

    此类错误码一般是输入参数不符合要求，例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求，您可以参考对应API文档中的请求参数表格进行检查确认。

  • 系统服务类错误码

    如果出现此类错误码，建议您重新发起服务请求，如果问题依然存在，请在钉钉群组（23109592）中反馈问题。