HTTP 狀態碼

下列狀態碼可在 HTTP 回應中傳回。

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

有時可能適用多個錯誤代碼。服務應傳回最適用的特定錯誤代碼。