下列狀態碼可在 HTTP 回應中傳回。
HTTP 代碼 | HTTP 說明 | 附註 |
---|---|---|
2xx | 知道了 | 非錯誤;於成功時傳回。這也應用於商業邏輯故障 (例如已填入 CreateBookingResponse 中的 booking_failure ) |
400 | 要求無效 | 要求無效/引數無效 (商家、服務、找不到時段、嘗試預訂無效的時段、取消不存在的預訂)。 |
401 | 未授權 | 未驗證 (憑證無效,需要重新登入);要求沒有該作業的有效驗證憑證。 |
403 | 禁止存取 | 權限遭拒/禁止 (拒絕了已知的呼叫端)。這項回應不得用於因耗用某些資源所導致的拒絕情形 (請針對這些錯誤改用 Too Many Requests )。如果無法識別呼叫端,請勿使用 Forbidden (請針對這些錯誤改用 Unauthorized )。 |
404 | 找不到 | 找不到,例如無法找到資源、網址無效,或是包含無效的遠端程序呼叫 (RPC)。 |
409 | 衝突 | 作業已取消,通常是排序器檢查失敗或交易取消等並行問題所造成。 |
429 | 要求數量過多 | 已耗盡某些資源,可能是每位使用者的配額,也可能是整個檔案系統的空間不足。 |
499 | 用戶端已結束要求 | 作業已取消 (通常由呼叫端取消)。 |
500 | 內部伺服器錯誤 | 發生內部錯誤,這表示基礎系統預期的某些不變量已遭破壞。此錯誤代碼保留供嚴重錯誤使用。 |
501 | 未執行 | 作業未實作或在此服務不支援/未啟用。 |
503 | 無法提供服務 | 服務目前無法使用。這極有可能是暫時情況,可透過重試輪詢來解決。 |
504 | 閘道逾時 | 已超過期限,但作業尚未完成。針對會變更系統狀態的作業,即便作業順利完成也有可能會傳回這個錯誤。舉例來說,雖然伺服器成功提供回應,但因為延遲時間過長而導致超過期限。 |
有時可能適用多個錯誤代碼。服務應傳回最適用的特定錯誤代碼。