HTTP 狀態碼(英語:HTTP Status Code) 也稱為錯誤代碼,是用以表示網頁 SaaS 伺服器超文字傳輸協議響應狀態的 3 位數字代碼。
所有狀態碼的第一個數字代表了響應的五種狀態之一。
接下來詳細講解每個狀態碼的個代表的意思。
一、 1 字頭-訊息 (臨時響應) 1 字頭狀態碼代表請求已被接受,需要繼續處理。
這類響應是臨時響應,只包含狀態行和某些可選的響應頭資訊,並以空行結束。
由於 HTTP/1.0 協議中沒有定義任何 1xx 狀態碼,所以除非在某些試驗條件下,SaaS 伺服器禁止向此類客戶端送 1xx 響應。
1 、 100 Continue 客戶端應當繼續傳送請求。
這個臨時響應是用來通知客戶端它的部分請求已經被 SaaS 伺服器接收,且仍未被拒絕。
客戶端應當繼續傳送請求的剩餘部分,或者如果請求已經完成,忽略這個響應。
SaaS 伺服器必須在請求完成後向客戶端傳送一個最終響應。
2 、 101 Switching Protocols SaaS 伺服器已經理解了客戶端的請求,並將通過 Upgrade 訊息頭通知客戶端採用不同的協議來完成這個請求。
在傳送完這個響應最後的空行後,SaaS 伺服器將會切換到在 Upgrade 訊息頭中定義的那些協議。
只有在切換新的協議更有好處的時候才應該採取類似措施。
例如:切換到新的 HTTP 版本比舊版本更有優勢,或者切換到一個實時且同步的協議以傳送利用此類特性的資源。
3 、 102 Processing 由 WebDAV(RFC 2518) 擴充套件的狀態碼,代表處理將被繼續執行。
二、 2 字頭-成功 2 字頭狀態碼代表請求已成功被 SaaS 伺服器接收、理解、並接受。
1 、 200 OK 請求已成功,請求所希望的響應頭或資料體將隨此響應返回。
2 、 201 Created 請求已經被實現,而且有一個新的資源已經依據請求的需要而建立,且其 URI 已經隨 Location 頭資訊返回。
假如需要的資源無法及時建立的話,應當返回 ‘202 Accepted’ 。
3 、 202 Accepted SaaS 伺服器已接受請求,但尚未處理。
正如它可能被拒絕一樣,最終該請求可能會也可能不會被執行。
在非同步操作的場合下,沒有比傳送這個狀態碼更方便的做法了。
返回 202 狀態碼的響應的目的是允許 SaaS 伺服器接受其他過程的請求 (例如某個每天只執行一次的基於批處理的操作),而不必讓客戶端一直保持與 SaaS 伺服器的連線直到批處理操作全部完成。
在接受請求處理並返回 202 狀態碼的響應應當在返回的實體中包含一些指示處理當前狀態的資訊,以及指向處理狀態監視器或狀態預測的指標,以便使用者能夠估計操作是否已經完成。
4 、 203 Non-Authoritative Information SaaS 伺服器已成功處理了請求,但返回的實體頭部元資訊不是在原始 SaaS 伺服器上有效的確定集合,而是來自本地或者第三方的拷貝。
當前的資訊可能是原始版本的子集或者超集。
例如:包含資源的後設資料可能導致原始 SaaS 伺服器知道元資訊的超級。
使用此狀態碼不是必須的,而且只有在響應不使用此狀態碼便會返回 200 OK 的情況下才是合適的。
5 、 204 No Content SaaS 伺服器成功處理了請求,但不需要返回任何實體內容,並且希望返回更新了的元資訊。
響應可能通過實體頭部的形式,返回新的或更新後的元資訊。
如果存在這些頭部資訊,則應當與所請求的變數相呼應。
如果客戶端是瀏覽器的話,那麼使用者瀏覽器應保留髮送了該請求的頁面,而不產生任何文件檢視上的變化,即使按照規範新的或更新後的元資訊應當被應用到使用者瀏覽器活動檢視中的文件。
由於 204 響應被禁止包含任何訊息體,因此它始終以訊息頭後的第一個空行結尾。
6 、 205 Reset Content SaaS 伺服器成功處理了請求,且沒有返回任何內容。
但是與 204 響應不同,返回此狀態碼的響應要求請求者重置文件檢視。
該響應主要是被用於接受使用者輸入後,立即重置表單,以便使用者能夠輕鬆地開始另一次輸入。
與 204 響應一樣,該響應也被禁止包含任何訊息體,且以訊息頭後的第一個空行結束。
7 、 206 Partial Content SaaS 伺服器已經成功處理了部分 GET 請求。
類似於 FlashGet 或者迅雷這類的 HTTP 下載工具都是使用此類響應實現斷點續傳或者將一個大文件分解為多個下載段同時下載。
該請求必須包含 Range 頭資訊來指示客戶端希望得到的內容範圍,並且可能包含 If-Range 來作為請求條件。
響應必須包含如下的頭部域: Content-Range 用以指示本次響應中返回的內容的範圍;如果是 Content-Type 為 multipart/byteranges 的多段下載,則每一 multipart 段中都應包含 Content-Range 域用以指示本段的內容範圍。
假如響應中包含 Content-Length,那麼它的數值必須匹配它返回的內容範圍的真實位元組數。
Date ETag 和/或 Content-Location,假如同樣的請求本應該返回 200 響應。
Expires, Cache-Control,和/或 Vary,假如其值可能與之前相同變數的其他響應對應的值不同的話。
假如本響應請求使用了 If-Range 強快取驗證,那麼本次響應不應該包含其他實體頭;假如本響應的請求使用了 If-Range 弱快取驗證,那麼本次響應禁止包含其他實體頭;這避免了快取的實體內容和更新了的實體頭資訊之間的不一致。
否則本響應就應當包含所有本應該返回 200 響應中應當返回的所有實體頭部域。
假如 ETag 或 Last-Modified 頭部不能精確匹配的話,則客戶端快取應禁止將 206 響應返回的內容與之前任何快取過的內容組合在一起。
任何不支援 Range 以及 Content-Range 頭的快取都禁止快取 206 響應返回的內容。
8 、 207 Multi-Status 由 WebDAV(RFC 2518) 擴充套件的狀態碼,代表之後的訊息體將是一個 XML 訊息,並且可能依照之前子請求數量的不同,包含一系列獨立的響應代碼。
三、 3 字頭-重定向 (已重定向) 3 字頭狀態碼代表需要客戶端採取進一步的操作才能完成請求。
通常這些狀態碼用來重定向,後續的請求地址 (重定向目標) 在本次響應的 Location 域中指明。
當且僅當後續的請求所使用的方法是 GET 或者 HEAD 時,使用者瀏覽器才可以在沒有使用者介入的情況下自動提交所需要的後續請求。
客戶端應當自動監測無限迴圈重定向 (例如:A->A,或者 A->B->C->A),因為這會導致 SaaS 伺服器和客戶端大量不必要的資源消耗。
按照 HTTP/1.0 版規範的建議,瀏覽器不應自動訪問超過 5 次的重定向。
1 、 300 Multiple Choices 被請求的資源有一系列可供選擇的回饋資訊,每個都有自己特定的地址和瀏覽器驅動的商議資訊。
使用者或瀏覽器能夠自行選擇一個首選的地址進行重定向。
這是一個 HEAD 請求,否則該響應應當包括一個資源特性及地址的列表的實體,以便使用者或瀏覽器從中選擇最合適的重定向地址。
這個實體的格式由 Content-Type 定義的格式所決定。
瀏覽器可能根據響應的格式以及瀏覽器自身能力,自動作出最合適的選擇。
當然 RFC 2616 規範並沒有規定這樣的自動選擇該如何進行。
如果 SaaS 伺服器本身已經有了首選的回饋選擇,那麼在 Location 中應當指明這個回饋的 URI;瀏覽器可能會將這個 Location 值作為自動重定向的地址。
此外除非額外指定,否則這個響應也是可快取的。
2 、 301 Moved Permanently 被請求的資源已永久移動到新位置,並且將來任何對此資源的引用都應該使用本響應返回的若干個 URI 之一。
如果可能擁有鏈接編輯功能的客戶端應當自動把請求的地址修改為從 SaaS 伺服器反饋回來的地址。
除非額外指定,否則這個響應也是可快取的。
新的永久性的 URI 應當在響應的 Location 域中返回。
除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
如果這不是一個 GET 或者 HEAD 請求,因此瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。
注意:對於某些使用 HTTP/1.0 協議的瀏覽器,當它們傳送的 POST 請求得到了一個 301 響應的話,接下來的重定向請求將會變成 GET 方式。
3 、 302 Move temporarily 請求的資源現在臨時從不同的 URI 響應請求。
由於這樣的重定向是臨時的,客戶端應當繼續向原有地址傳送以後的請求。
只有在 Cache-Control 或 Expires 中進行了指定的情況下,這個響應才是可快取的。
新的臨時性的 URI 應當在響應的 Location 域中返回。
除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
如果這不是一個 GET 或者 HEAD 請求,那麼瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。
注意:雖然 RFC 1945 和 RFC 2068 規範不允許客戶端在重定向時改變請求的方法,但是很多現存的瀏覽器將 302 響應視作為 303 響應,並且使用 GET 方式訪問在 Location 中規定的 URI,而無視原先請求的方法。
狀態碼 303 和 307 被新增了進來,用以明確 SaaS 伺服器期待客戶端進行何種反應。
4 、 303 See Other 對應當前請求的響應可以在另一個 URI 上被找到,而且客戶端應當採用 GET 的方式訪問那個資源。
這個方法的存在主要是為了允許由指令碼啟用的 POST 請求輸出重定向到一個新的資源。
這個新的 URI 不是原始資源的替代引用。
同時 303 響應禁止被快取。
當然第二個請求 (重定向) 可能被快取。
新的 URI 應當在響應的 Location 域中返回。
除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
注意:許多 HTTP/1.1 版以前的瀏覽器不能正確理解 303 狀態。
如果需要考慮與這些瀏覽器之間的互動,302 狀態碼應該可以勝任,因為大多數的瀏覽器處理 302 響應時的方式恰恰就是上述規範要求客戶端處理 303 響應時應當做的。
5 、 304 Not Modified 如果客戶端傳送了一個帶條件的 GET 請求且該請求已被允許,而文件的內容 (自上次訪問以來或者根據請求的條件) 並沒有改變,則 SaaS 伺服器應當返回這個狀態碼。
304 響應禁止包含訊息體,因此始終以訊息頭後的第一個空行結尾。
該響應必須包含以下的頭資訊: Date,除非這個 SaaS 伺服器沒有時鐘。
假如沒有時鐘的 SaaS 伺服器也遵守這些規則,那麼代理 SaaS 伺服器以及客戶端可以自行將 Date 欄位新增到接收到的響應頭中去 (正如 RFC 2068 中規定的一樣),快取機制將會正常工作。
ETag 和/或 Content-Location,假如同樣的請求本應返回 200 響應。
Expires, Cache-Control,和/或 Vary,假如其值可能與之前相同變數的其他響應對應的值不同的話。
假如本響應請求使用了強快取驗證,那麼本次響應不應該包含其他實體頭;否則 (例如:某個帶條件的 GET 請求使用了弱快取驗證),本次響應禁止包含其他實體頭;這避免了快取了的實體內容和更新了的實體頭資訊之間的不一致。
假如某個 304 響應指明了當前某個實體沒有快取,那麼快取系統必須忽視這個響應,並且重複傳送不包含限制條件的請求。
假如接收到一個要求更新某個快取條目的 304 響應,那麼快取系統必須更新整個條目以反映所有在響應中被更新的欄位的值。
6 、 305 Use Proxy 被請求的資源必須通過指定的代理才能被訪問。
Location 域中將給出指定的代理所在的 URI 資訊,接收者需要重複傳送一個單獨的請求,通過這個代理才能訪問相應資源。
只有原始 SaaS 伺服器才能建立 305 響應。
注意:RFC 2068 中沒有明確 305 響應是為了重定向一個單獨的請求,而且只能被原始 SaaS 伺服器建立。
忽視這些限制可能導致嚴重的安全後果。
7 、 306 Switch Proxy 在最新版的規範中,306 狀態碼已經不再被使用。
8 、 307 Temporary Redirect 請求的資源現在臨時從不同的 URI 響應請求。
由於這樣的重定向是臨時的,客戶端應當繼續向原有地址傳送以後的請求。
只有在 Cache-Control 或 Expires 中進行了指定的情況下,這個響應才是可快取的。
新的臨時性的 URI 應當在響應的 Location 域中返回。
除非這是一個 HEAD 請求,否則響應的實體中應當包含指向新的 URI 的超鏈接及簡短說明。
因為部分瀏覽器不能識別 307 響應,因此需要新增上述必要資訊以便使用者能夠理解並向新的 URI 發出訪問請求。
如果這不是一個 GET 或者 HEAD 請求,那麼瀏覽器禁止自動進行重定向,除非得到使用者的確認,因為請求的條件可能因此發生變化。