回傳適當的狀態碼

於每個回應回傳適當的狀態碼。成功地回應應該根據以下原則編碼:

  • 200: 同步需求執行成功,包含 GET 呼叫、DELETEPATCH 呼叫、PUT 更新資源呼叫。

  • 201: 同步需求執行成功,包含 POST 呼叫,及 PUT 建立資源呼叫。

  • 202: 非同步需求已接受,包含 POSTPUTDELETEPATCH

  • 206: GET 需求成功,但只回傳部分回應。詳見前一章以 Range 分頁

謹慎使用認證與授權的錯誤碼:

  • 401 Unauthorized: 需求失敗,因為使用者未經認證。

  • 403 Forbidden: 需求失敗,由於使用者未經授權即存取特定資源。

回傳適合的狀態碼以提供錯誤資訊:

  • 422 Unprocessable Entity: 需求可被理解,但含有無效的參數。

  • 429 Too Many Requests: 超過次數限制,等下再試。

  • 500 Internal Server Error: 伺服器端出錯,應檢查站台狀態或回報問題。

參考 HTTP response code spec 規範來對應使用者錯誤及伺服器錯誤的案例。

Last updated

Was this helpful?