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 金鑰、共用密碼與 UNIX 時間戳記 (單位為秒) 的 Unsalted SHA-512 雜湊。如欲瞭解完整詳細資料，請參閱我們的簽章授權頁面。

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 回應，表示找不到所要求的地理位置、內容特定檔案或資源。如需完整範例，請參閱這些 API 各自的文件頁面。

{
    "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."
}