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:<虛擬主機名稱>」和 url:<path>
405 系統不允許的方法。系統不支援您指定的方法。舉例來說,對於需要 POST 動詞的 API 呼叫,您使用了 GET 動詞。
409 衝突。表示與現有實體發生衝突。例如,您嘗試使用已存在的名稱建立快取。
415 不支援的媒體類型。通常是在 POST 或 PUT 上發生這個錯誤 Content-typeHTTP 標頭設為錯誤值時的要求。例如: 如果您以 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 Bad Gateway
503 請參閱「503 Service Unavailable」。
504 請參閱 504 閘道逾時