HTTP 狀態碼

您目前查看的是 Apigee Edge 說明文件。
參閱 Apigee X 說明文件。 資訊

Edge API 回應錯誤訊息包含 HTTP 狀態碼和錯誤訊息。

例如，如果您嘗試以現有快取的名稱建立快取實體，則回應如下：

HTTP/1.1 409 Conflict
{
  "code": "messaging.config.beans.CacheAlreadyExists",
  "message": "Cache duplicate_cache already exists in environment test",
  "contexts": []
}

下表概略說明最常見的 HTTP 狀態碼，以及這些代碼在 Apigee Edge 中代表的意義。

HTTP 狀態碼 說明
2xx 成功。API 呼叫成功。HTTP 204 表示提交回應不含任何內容，通常是因為 DELETE 作業成功。
401 未經授權，您用來發出要求的憑證沒有執行執行作業的適當權限。請確認您目前使用的帳戶的角色。
403 已禁止。您使用的使用者名稱和密碼組合不適用於您指定的機構。如要測試憑證，請登入 login.apigee.com/login。如果您需要帳戶，請註冊。

請務必使用正確的貴機構憑證，並再次檢查拼字。
404 找不到任何結果。確認要求網址的拼寫正確無誤，以及您要存取的 API 是否存在。例如，請確保您並未嘗試存取錯誤的 API 修訂版本。另請參閱「404 無法識別主機的 Proxy：<虛擬主機名稱> 和網址：<路徑>」。
405 系統不允許的方法。您指定的方法不受支援。例如，您使用 GET 動詞執行需要 POST 動詞的 API 呼叫。
409 衝突。表示與現有實體相衝突。舉例來說，您嘗試建立快取時使用了已存在的名稱。
415 不支援的媒體類型。通常，如果 Content-type HTTP 標頭設為錯誤的值，就會發生在 POST 或 PUT 要求上發生這個錯誤。舉例來說，如果您將下列程式碼 POST 到僅支援 JSON 的 API，系統就會傳回 HTTP 415 錯誤： 
$ curl https://api.company.com/v1/json_service
  -X POST
  -H "Content-type:text/xml"
  -d '<SomeXML>'

如果是 GET 要求，請使用 Accept 標頭，而非 Content-type 標頭。
429 要求數量過多。超過配額或尖峰流量防範政策的頻率限制。超過頻率限制的目前預設狀態碼為 500，但日後可能會變更為 429。請參閱垃圾防範政策和配額政策，瞭解如何將 500 變更為 429。
500 小時 請參閱「500 內部伺服器錯誤」。
502 請參閱「502 錯誤的閘道」。
503 請參閱「503 服務無法使用」。
504 請參閱「504 閘道逾時」。