你需要瞭解的 HTTP Status Code

Intro

現在前後端分離的開發模式越來越流行，後端負責開發對應的 API，前端只需要
關註前端頁面的數據展示和前端邏輯即可。

對於前後端分離這種開發模式，我個人還是比較喜歡的，因為這樣可以讓更專業的人做更專業的事情，後端專註於做 API 的開發設計，前端專註於數據的展示，頁面的樣式。

這樣前後端需要就某些信息達成一些共識，比如說常用的 HTTP 方法, 常用的 HTTP 狀態碼等

HTTP Method 較為簡單，我們常用的習慣如下：

一般查詢我們都會使用 GET 方法，
創建新的記錄使用 POST 方法
更新已有數據使用 PUT 方法
更新已有數據部分屬性使用 PATCH 方法
刪除已有數據使用 DELETE 方法

下麵來詳細介紹一下常用的 HTTP 狀態碼

1xx

1xx 狀態碼一般是一個請求的中間狀態，一般是信息提示，請求協商

100 Continue，請求未結束，應該繼續請求

101 Switching Protocol，協議轉換，在使用 Web Socket 的時候就會遇到，下麵是一個示例，響應會有一個 Connection: Upgrade 的請求頭，Upgrade 會指定要使用的協議名稱

2xx

2xx 一般表示請求處理成功

200 OK，請求處理成功

201 Created，請求處理成功，並且新資源已經創建

202 Accepted，請求已經接受，正在處理，尚未處理完成

204 No Content，響應內容為空，在 asp.net core 中返回一個 Json(null) 的時候就會是一個 NoContent 的結果

3xx

3xx 一般表示重定向

301 Moved Permanently 永久重定向

302 Found 臨時重定向

307 Temporary Redirect 臨時重定向請求

308 Permanent Redirect 永久重定向請求

這幾個重定向的區別：
301、302 只支持 GET 請求，如果是 POST 請求，重定向後會使用 GET 請求且 Body 數據會丟失

307、308 支持 POST 請求，在 POST 重定向的時候會帶上原來請求的 body 再請求新的地址，body 數據不會丟失

302、307 是臨時重定向，
301、308 是永久重定向，是允許緩存的，瀏覽器可以緩存

304 Not Modified，資源未發生修改，可以直接使用瀏覽器本地緩存

This is the response code to an If-Modified-Since or If-None-Match header, where the URL has not been modified since the specified date.

4xx

4xx 一般表示客戶端請求錯誤

400 BadRequest，錯誤請求，一般用來表示請求參數異常，比如請求的某一個參數不能為空，但實際請求是空

401 Unauthorized，未授權，資源需要授權或登錄，而用戶沒有登錄或者沒有提供訪問所需的 Token 等

403 Forbidden，禁止訪問，當前用戶沒有許可權訪問資源，如需要Admin角色的用戶，但是請求的用戶沒有這個角色

404 NotFound，未找到資源，資源不存在

405 Method Not Allowed，不允許的方法調用，資源不支持的請求方法，比如資源只允許 GET 請求，但是實際請求使用了 POST 或 DELETE 方法

406 Not Acceptable，請求的資源客戶端不支持處理，比如客戶端希望獲取 xml 的響應，但是伺服器端只支持 JSON 響應

408 Request Timeout, 請求處理超時

409 Conflict，請求資源衝突，常發生在 PUT 更新資源信息時發生，比如更新時指定資源的 ETAG，但是PUT請求時，資源的 ETAG 已經發生變化

410 Gone，請求資源在源伺服器上不再可用

411 Length Required，請求需要攜帶 Content-Length 請求頭

412 Precondition Failed，請求預檢失敗，請求的某些參數不符合條件

The pre condition given in the request evaluated to false by the server.

413 Payload Too Large，請求的參數太大，請求的 body 過大，伺服器拒絕處理

414 URI Too Long，請求的 URI 地址太長，伺服器拒絕處理

415 Unsupported Media Type，不支持的媒體類型或不支持的編碼，比如伺服器只支持處理 JSON 請求，但是請求是 xml 格式

The 415 (Unsupported Media Type) status code indicates that the
origin server is refusing to service the request because the payload
is in a format not supported by this method on the target resource.
The format problem might be due to the request's indicated
Content-Type or Content-Encoding, or as a result of inspecting the
data directly.

5xx

5xx 一般表示服務端錯誤

500 Internal Server Error，伺服器內部錯誤

501 Not Implemented 伺服器不支持需要處理請求的功能，比如圖片壓縮等處理

502 Bad Gateway 反向代理或網關找不到處理請求的伺服器

503 Service Unavailable 服務不可用

504 Gateway Timeout 網關超時

505 HTTP Version Not Supported，不支持的 HTTP 版本，伺服器不支持或拒絕處理這個 HTTP 版本的請求

Reference

• https://www.tutorialspoint.com/http/http_status_codes.htm
• https://developer.mozilla.org/en-US/docs/Web/HTTP/Status
• https://tools.ietf.org/html/rfc7231#section-6.2