2014年4月22日 星期二

HTTP 狀態碼(Status code)

一般人對於 HTTP 狀態碼(Status code) 多少都會有些印象。但一般人大多不會仔細看所有 HTTP 狀態碼的定義及它對開發人員來說有何影響。雖然完全不瞭解 HTTP 狀態碼也可以開發出一個網站,但若是網站架構越來越大,或是系統整合時,若不瞭解這些代碼的意義,可能很容易就遇到瓶頸,因此在這裡把 HTTP 狀態碼分享給大家知道。

以下資訊參考自 維基百科

1xx 訊息
這一型別的狀態碼,代表請求已被接受,需要繼續處理。


100 Continue
客戶端應當繼續發送請求。這個臨時響應是用來通知客戶端它的部分請求已經被伺服器接收,且仍未被拒絕。

101 Switching Protocols
伺服器已經理解了客戶端的請求,並將透過 Upgrade 訊息頭通知客戶端採用不同的協定來完成這個請求。

102 Processing
由 WebDAV(RFC 2518)擴充功能的狀態碼,代表處理將被繼續執行。




2xx 成功
這一型別的狀態碼,代表請求已成功被伺服器接收、理解、並接受。


200 OK
請求已成功,請求所希望的響應頭或資料體將隨此響應返回。

201 Created
請求已經被實作,而且有一個新的資源已經依據請求的需要而建立,且其 URI 已經隨 Location 頭訊息返回。

202 Accepted
伺服器已接受請求,但尚未處理。正如它可能被拒絕一樣,最終該請求可能會也可能不會被執行。在非同步操作的場合下,沒有比發送這個狀態碼更方便的做法了。

203 Non-Authoritative Information
伺服器已成功處理了請求,但返回的實體頭部元訊息不是在原始伺服器上有效的確定集合,而是來自本地或者第三方的拷貝。當前的訊息可能是原始版本的子集或者超集。

204 No Content
伺服器成功處理了請求,但不需要返回任何實體內容,並且希望返回更新了的元訊息。響應可能透過實體頭部的形式,返回新的或更新後的元訊息。

205 Reset Content
伺服器成功處理了請求,且沒有返回任何內容。但是與 204 響應不同,返回此狀態碼的響應要求請求者重置文件檢視。該響應主要是被用於接受使用者輸入後,立即重置表單,以便使用者能夠輕鬆地開始另一次輸入。

206 Partial Content
伺服器已經成功處理了部分 GET 請求。類似於 FlashGet 或者迅雷這類的 HTTP 下載工具都是使用此類響應實作斷點續傳或者將一個大文件分解為多個下載段同時下載。
該請求必須包含 Range 頭訊息來指示客戶端希望得到的內容範圍,並且可能包含 If-Range 來作為請求條件。

207 Multi-Status
由 WebDAV(RFC 2518)擴充功能的狀態碼,代表之後的訊息體將是一個 XML 訊息,並且可能依照之前子請求數量的不同,包含一系列獨立的響應代碼。




3xx 重定向
這類狀態碼代表需要客戶端採取進一步的操作才能完成請求。


300 Multiple Choices
被請求的資源有一系列可供選擇的回饋訊息,每個都有自己特定的位址和瀏覽器驅動的商議訊息。使用者或瀏覽器能夠自行選擇一個首選的位址進行重定向。

301 Moved Permanently
被請求的資源已永久移動到新位置,並且將來任何對此資源的參照都應該使用本響應返回的若干個 URI 之一。

302 Found
請求的資源現在臨時從不同的 URI 響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有位址發送以後的請求。

303 See Other
對應當前請求的響應可以在另一個 URI 上被找到,而且客戶端應當採用 GET 的方式存取那個資源。這個方法的存在主要是為了允許由指令碼啟用的 POST 請求輸出重定向到一個新的資源。

304 Not Modified
如果客戶端發送了一個帶條件的 GET 請求且該請求已被允許,而文件的內容(自上次存取以來或者根據請求的條件)並沒有改變,則伺服器應當返回這個狀態碼。

305 Use Proxy
被請求的資源必須透過指定的代理才能被存取。Location 域中將給出指定的代理所在的 URI 訊息,接收者需要重複發送一個單獨的請求,透過這個代理才能存取相應資源。只有原始伺服器才能建立 305 響應。

306 Switch Proxy
在最新版的規範中,306 狀態碼已經不再被使用。

307 Temporary Redirect
請求的資源現在臨時從不同的 URI 響應請求。由於這樣的重定向是臨時的,客戶端應當繼續向原有位址發送以後的請求。只有在 Cache-Control 或 Expires 中進行了指定的情況下,這個響應才是可快取的。




4xx 請求錯誤
這類的狀態碼代表了客戶端看起來可能發生了錯誤,妨礙了伺服器的處理。 


400 Bad Request
由於包含語法錯誤,當前請求無法被伺服器理解。

401 Unauthorized
當前請求需要使用者驗證。該響應必須包含一個適用於被請求資源的 WWW-Authenticate 訊息頭用以詢問使用者訊息,客戶端可以重複送出一個包含恰當的 Authorization 頭訊息的請求。

402 Payment Required
該狀態碼是為了將來可能的需求而預留的。

403 Forbidden
伺服器已經理解請求,但是拒絕執行它。與 401 響應不同的是,身份驗證並不能提供任何幫助,而且這個請求也不應該被重複送出。

404 Not Found
請求失敗,請求所希望得到的資源未被在伺服器上發現。沒有訊息能夠告訴使用者這個狀況到底是暫時的還是永久的。

405 Method Not Allowed
請求行中指定的請求方法不能被用於請求相應的資源。該響應必須返回一個 Allow 頭訊息用以表示出當前資源能夠接受的請求方法的列表。

406 Not Acceptable
請求的資源的內容特性無法滿足請求頭中的條件,因而無法生成響應實體。

407 Proxy Authentication Required
與 401 響應類似,只不過客戶端必須在代理伺服器上進行身份驗證。代理伺服器必須返回一個 Proxy-Authenticate 用以進行身份詢問。客戶端可以返回一個 Proxy-Authorization 訊息頭用以驗證。

408 Request Timeout
請求超時。客戶端沒有在伺服器預備等待的時間內完成一個請求的發送。

409 Conflict
由於和被請求的資源的當前狀態之間存在衝突,請求無法完成。

410 Gone
被請求的資源在伺服器上已經不再可用,而且沒有任何已知的轉發位址。這樣的狀況應當被認為是永久性的。

411 Length Required
伺服器拒絕在沒有定義 Content-Length 頭的情況下接受請求。

412 Precondition Failed
伺服器在驗證在請求的頭欄位中給出先決條件時,沒能滿足其中的一個或多個。

413 Request Entity Too Large
伺服器拒絕處理當前請求,因為該請求送出的實體資料大小超過了伺服器願意或者能夠處理的範圍。

414 Request-URI Too Long
請求的 URI 長度超過了伺服器能夠解釋的長度,因此伺服器拒絕對該請求提供服務。

415 Unsupported Media Type
對於當前請求的方法和所請求的資源,請求中送出的實體並不是伺服器中所支援的格式,因此請求被拒絕。

416 Requested Range Not Satisfiable
如果請求中包含了 Range 請求頭,並且 Range 中指定的任何資料範圍都與當前資源的可用範圍不重合,同時請求中又沒有定義 If-Range 請求頭,那麼伺服器就應當返回 416 狀態碼。

417 Expectation Failed
在請求頭 Expect 中指定的預期內容無法被伺服器滿足,或者這個伺服器是一個代理伺服器,它有明顯的證據證明在當前路由的下一個節點上,Expect 的內容無法被滿足。

421 There are too many connections from your internet address
從當前客戶端所在的 IP 位址到伺服器的連線數超過了伺服器許可的最大範圍。

422 Unprocessable Entity
請求格式正確,但是由於含有語意錯誤,無法響應。

423 Locked
當前資源被鎖定。

424 Failed Dependency
由於之前的某個請求發生的錯誤,導致當前請求失敗。

426 Upgrade Required
客戶端應當切換到 TLS/1.0。




5xx 伺服器錯誤
這類狀態碼代表了伺服器在處理請求的過程中有錯誤或者異常狀態發生,也有可能是伺服器意識到以當前的軟硬體資源無法完成對請求的處理。


500 Internal Server Error
伺服器遇到了一個未曾預料的狀況,導致了它無法完成對請求的處理。

501 Not Implemented
伺服器不支援當前請求所需要的某個功能。

502 Bad Gateway
作為閘道器或者代理工作的伺服器嘗試執行請求時,從上游伺服器接收到無效的響應。

503 Service Unavailable
由於臨時的伺服器維護或者過載,伺服器當前無法處理請求。

504 Gateway Timeout
作為閘道器或者代理工作的伺服器嘗試執行請求時,未能及時從上游伺服器或輔助伺服器收到響應。

505 HTTP Version Not Supported
伺服器不支援,或者拒絕支援在請求中使用的HTTP版本。這暗示著伺服器不能或不願使用與客戶端相同的版本。

507 Insufficient Storage
伺服器無法儲存完成請求所必須的內容。這個狀況被認為是臨時的。

509 Bandwidth Limit Exceeded
伺服器達到頻寬限制。這不是一個官方的狀態碼,但是仍被廣泛使用。

510 Not Extended
獲取資源所需要的策略並沒有沒滿足。

沒有留言:

張貼留言