狀態回應代碼

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

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

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