Your EPS account

Reset your password

Please enter your email address below. We will send password reset instructions to the email associated with your EPS account.

Back to sign in

常见错误响应

EPS Rapid 的 API 服务会共享下列常见错误代码、消息和响应格式。请参考我们的各个文档页面，查看特定于每项服务的错误响应。

400 - Bad Request (错误请求)

您的请求畸形或者包含不正确的值时返回。响应正文将指出不正确的字段的名称及其类型，以及接收的服务的值。新 API 下的所有服务和方法都会使用此格式。

示例响应

不支持的语言：

{
  "type": "invalid_input",
  "message": "An invalid request was sent in, please check the nested errors for details.",
  "errors": [
    {
      "type": "language.not_supported",
      "message": "Language is not supported. Supported languages are: [de-DE, en-US, es-ES, es-MX, fr-FR, id-ID, it-IT, ja-JP, ko-KR, pt-BR, zh-CN]",
      "fields": [
        {
          "name": "language",
          "type": "querystring",
          "value": "xx-XX"
        }
      ]
    }
  ]
}

缺少版本值：

{
  "type": "version.required",
  "message": "You have not specified a version, the supported versions are: [1, 2]",
  "fields": [
    {
      "name": "version",
      "type": "path",
      "value": "missing"
    }
  ]
}

无效的版本值：

{
  "type": "version.unsupported",
  "message": "You have requested a version that is not supported, supported versions are: [1, 2]",
  "fields": [
    {
      "name": "version",
      "type": "path",
      "value": "3"
    }
  ]
}

401 - Unauthorized (未授权)

找不到或无法分析 HTTP 授权标头时返回。任何 EAN 的 API 服务必须包括您的 API 密钥串联的未加盐 SHA-512 哈希 + 共享密钥 + UNIX 时间戳（以秒为单位）。有关完整的详细信息，请参考我们的签名授权页面。

示例 400 未授权响应：

{
  "type": "request_unauthenticated",
  "message": "Data required to authenticate your request is missing. Ensure that your request follows the guidelines in our documentation."
}

403 - Forbidden (禁止)

当您的 HTTP 授权标头有效时返回，但不允许访问请求的资源。

示例 403 禁止响应：

{
  "type": "request_unauthenticated",
  "message": "Your request could not be authenticated. Ensure that your request follows the guidelines in our documentation.",
  "fields": [
    {
      "name": "apikey",
      "type": "header",
      "value": "jaj3982k239dka328e"
    },
    {
      "name": "signature",
      "type": "header",
      "value": "129d75332614a5bdbe0c7eb540e95a65f9d85a5b53dabb38d19b37fad6312a2bd25c12ee5a82831d55112087e1b"
    },
    {
      "name": "timestamp",
      "type": "header",
      "value": 198284729
    },
    {
      "name": "servertimestamp",
      "type": "server",
      "value": 198284729
    }
  ]
}

404 - Not Found (未找到)

找不到请求的 API 资源时返回。请检查您的请求 URL，并与我们的记录示例核对。

地理 API 和内容 API 也使用 404 响应表示找不到请求的地理或内容特定文件或资源。有关完整的示例，请参考其相应的文档页面。

{
    "type": "resource.not_found",
    "message": "The requested resource could not be found."
}

426 - Upgrade Required (需要升级)

请求未使用 TLS 时返回（取代 SSL）。

{
  "type": "upgrade_required",
  "message": "This service requires the use of TLS."
}

500 - Internal Server Error (内部服务器错误)

在 EPS 的 API 或上游系统内返回错误。请再次尝试您的请求。

{
  "type": "unknown_internal_error",
  "message": "An internal server error has occurred."
}

503 - Service Unavailable (服务不可用)

返回请求的服务是否存在技术服务。可能包含 Retry-After 标头，以指示再次尝试前的最短延迟时间（以秒为单位）。

{
  "type": "service_unavailable",
  "message": "This service is currently unavailable."
}