HTTP 狀態碼

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

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 不允許的方法：不支援您指定的方法，例如針對需要動詞 POST 的 API 呼叫使用動詞 GET。
409 衝突：代表與現有實體發生衝突，例如使用重複的名稱建立快取。
415 不支援的媒體類型：一般來說，在 POST 或 PUT 要求，如果 Content-type HTTP 標頭的設定值有誤，就會發生這個錯誤。舉例來說，假設以 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 Internal Server Error」。
502 請參閱「502 Bad Gateway」。
503 請參閱「503 無法提供服務」。
504 請參閱「504 Gateway Timeout」。