跳至主要內容

會回傳哪些 HTTP 狀態碼?

每個錯誤都帶有 HTTP 狀態碼與固定的錯誤代碼。請依據錯誤代碼而非錯誤訊息進行分支處理。

每個錯誤回應都包含一個錯誤代碼,以及一則供人閱讀的訊息。錯誤代碼如下:

  • 400 invalid_parameter:參數未知、格式錯誤或超出範圍
  • 400 invalid_cursor:游標格式錯誤、已過期,或是為其他金鑰或其他篩選條件核發的
  • 401 unauthenticated:未傳送金鑰,或金鑰無法辨識或已被撤銷
  • 403 ip_not_allowed(請求來源 IP 位址未登記)、key_paused(金鑰已暫停)、country_not_entitled(國家不在訂閱範圍內)或 upgrade_required(需要升級):詳情請參閱「為什麼我會收到 403 錯誤?」
  • 404 not_found:路徑不存在
  • 405 method_not_allowed:所有端點都只接受 GET
  • 429 rate_limited(超出速率限制)或 quota_exceeded(配額已用完):請等待 Retry-After 標頭所指定的等待時間
  • 500 internal_error:請稍後重試
  • 503 not_configured 或 service_unavailable:請稍後重試

日後可能會新增代碼。如果遇到無法辨識的代碼,請將其視為隨附 HTTP 狀態碼所代表的失敗。

仍需要協助嗎?

如果這未能解答您的問題,請與我們聯絡,我們會提供協助。

聯絡支援團隊