Http請求狀态碼說明

2023-06-07 23:18:31

狀态碼清單

200 OK : 請求執行成功并傳回相應資料，如 GET 成功
201 Created : 對象建立成功并傳回相應資源資料，如 POST 成功；建立完成後響應頭中應該攜帶頭标 Location ，指向建立資源的位址
202 Accepted : 接受請求，但無法立即完成建立行為，比如其中涉及到一個需要花費若幹小時才能完成的任務。傳回的實體中應該包含目前狀态的資訊，以及指向處理狀态螢幕或狀态預測的指針，以便用戶端能夠擷取最新狀态。
204 No Content : 請求執行成功，不傳回相應資源資料，如 PATCH ， DELETE 成功

重定向的新位址都需要在響應頭

Location

中傳回

400 Bad Request : 請求體包含文法錯誤
401 Unauthorized : 需要驗證使用者身份，如果伺服器就算是身份驗證後也不允許客戶通路資源，應該響應 403 Forbidden
403 Forbidden : 伺服器拒絕執行
404 Not Found : 找不到目标資源
405 Method Not Allowed : 不允許執行目标方法，響應中應該帶有 Allow 頭，内容為對該資源有效的 HTTP 方法
406 Not Acceptable : 伺服器不支援用戶端請求的内容格式，但響應裡會包含服務端能夠給出的格式的資料，并在 Content-Type 中聲明格式名稱
410 Gone : 被請求的資源已被删除，隻有在确定了這種情況是永久性的時候才可以使用，否則建議使用 404 Not Found
413 Payload Too Large : POST 或者 PUT 請求的消息實體過大
415 Unsupported Media Type : 伺服器不支援請求中送出的資料的格式
422 Unprocessable Entity : 請求格式正确，但是由于含有語義錯誤，無法響應
428 Precondition Required : 要求先決條件，如果想要請求能成功必須滿足一些預設的條件

500 Internal Server Error : 伺服器遇到了一個未曾預料的狀況，導緻了它無法完成對請求的處理。
501 Not Implemented : 伺服器不支援目前請求所需要的某個功能。
502 Bad Gateway : 作為網關或者代理工作的伺服器嘗試執行請求時，從上遊伺服器接收到無效的響應。
503 Service Unavailable : 由于臨時的伺服器維護或者過載，伺服器目前無法處理請求。這個狀況是臨時的，并且将在一段時間以後恢複。如果能夠預計延遲時間，那麼響應中可以包含一個 Retry-After 頭用以标明這個延遲時間（内容可以為數字，機關為秒；或者是一個Http協定指定時間格式）。如果沒有給出這個 Retry-After 資訊，那麼用戶端應當以處理 500 響應的方式處理它。

與

的差別是：

是表示服務端不允許用戶端這麼做，

是表示用戶端或許可以這麼做，但服務端還沒有實作這個功能