前言

昨天我們學會了 RESTful API 的設計原則與 URI 規範。
今天，我們要深入 HTTP 狀態碼，了解如何正確回應客戶端請求，讓 API 更清晰、專業且符合最佳實務。

HTTP 狀態碼概念

HTTP 狀態碼是伺服器回應客戶端請求時，附帶的「數字訊號」，用來表示請求結果。
HTTP 狀態碼分為五類：

常見狀態碼

RESTful API 回應範例

假設我們有一個「Todo API」：

取得單一 Todo

GET /todos/1

成功回應：

json
HTTP/1.1 200 OK
{
  "id": 1,
  "title": "學習 RESTful API",
  "done": false
}

找不到資源回應：

HTTP/1.1 404 Not Found
{
  "error": "Todo 不存在"
}

最佳實務建議

1.使用正確狀態碼：不要所有錯誤都回 500。
2.清楚的錯誤訊息：讓開發者或前端知道問題所在。
3.統一格式：所有錯誤訊息應遵循同一格式，例如：

{
  "code": 404,
  "message": "資源不存在",
  "timestamp": "2025-09-01T14:00:00Z"
}

4.避免洩漏敏感訊息：伺服器錯誤不要暴露程式堆疊或資料庫訊息。