?
本文檔使用 php中文網(wǎng)手冊 發(fā)布
HTTP響應(yīng)狀態(tài)代碼指示特定的HTTP請求是否已成功完成。響應(yīng)分為五類:信息響應(yīng),成功響應(yīng),重定向,客戶端錯誤和服務(wù)器錯誤。狀態(tài)碼由RFC 2616的第10部分定義。
100 Continue
這個臨時響應(yīng)表明,到目前為止,所有事情都可以確定,并且客戶端應(yīng)該繼續(xù)請求或者在請求已經(jīng)完成時忽略它。101 Switching Protocol
此代碼是為了響應(yīng)Upgrade
客戶端的請求標(biāo)頭而發(fā)送的,并指示服務(wù)器也正在切換的協(xié)議。102 Processing
(WebDAV)此代碼表示服務(wù)器已接收并正在處理請求,但尚未有響應(yīng)。
200 OK
該請求已成功。成功的意義取決于HTTP方法:
GET:資源已被提取并在消息體中傳輸。
HEAD:實(shí)體頭部位于消息體中。
POST:描述操作結(jié)果的資源在消息主體中傳輸。
TRACE:消息正文包含服務(wù)器接收到的請求消息201 Created
請求已成功并且由于此請求已創(chuàng)建新資源。這通常是在PUT請求之后發(fā)送的響應(yīng)。202 Accepted
該請求已收到,但尚未執(zhí)行。它是非承諾的,這意味著HTTP中沒有辦法稍后發(fā)送指示處理請求結(jié)果的異步響應(yīng)。它適用于其他進(jìn)程或服務(wù)器處理請求或批處理的情況。203 Non-Authoritative Information
此響應(yīng)代碼意味著返回的元信息集不是從源服務(wù)器準(zhǔn)確設(shè)置的,而是從本地或第三方副本收集的。除了這種情況外,應(yīng)該優(yōu)先選擇200 OK響應(yīng)而不是此響應(yīng)。204 No Content
沒有要發(fā)送此請求的內(nèi)容,但標(biāo)題可能很有用。用戶代理可以用新的更新它的這個資源的緩存標(biāo)題。205 Reset Content
此響應(yīng)代碼在完成請求以告知用戶代理重置發(fā)送此請求的文檔視圖后發(fā)送。206 Partial Content
使用此響應(yīng)代碼是因為客戶端發(fā)送的范圍標(biāo)題將分隔下載到多個流中。207 Multi-Status
(WebDAV)在多個狀態(tài)代碼可能適用的情況下,多狀態(tài)響應(yīng)傳達(dá)有關(guān)多個資源的信息。208 Multi-Status
(WebDAV)在DAV:propstat響應(yīng)元素中使用,以避免重復(fù)枚舉多個綁定的內(nèi)部成員到同一個集合。226 IM Used
(HTTP Delta編碼)服務(wù)器已經(jīng)完成了對資源的GET請求,并且響應(yīng)是應(yīng)用于當(dāng)前實(shí)例的一個或多個實(shí)例操作結(jié)果的表示。
300 Multiple Choice
該請求有多個可能的響應(yīng)。用戶代理或用戶應(yīng)該選擇其中之一。沒有標(biāo)準(zhǔn)化的方式來選擇其中一個響應(yīng)。301 Moved Permanently
該響應(yīng)碼意味著請求資源的URI已被更改。可能會在響應(yīng)中提供新的URI。302 Found
該響應(yīng)碼意味著請求資源的URI已被臨時改變。將來可能會對URI進(jìn)行新的更改。因此,客戶端在未來的請求中應(yīng)該使用相同的URI。303 See Other
服務(wù)器發(fā)送此響應(yīng)以指示客戶端使用GET請求獲取請求的資源到另一個URI。304 Not Modified
這用于緩存目的。它告訴客戶,響應(yīng)沒有被修改。所以,客戶端可以繼續(xù)使用相同的緩存版本的響應(yīng)。305 Use Proxy
在HTTP規(guī)范的先前版本中定義為指示必須由代理訪問請求的響應(yīng)。由于代理的帶內(nèi)配置的安全問題,它已被棄用。306 unused
此響應(yīng)代碼不再使用,它只是保留在當(dāng)前。它用于HTTP 1.1規(guī)范的先前版本。307 Temporary Redirect
服務(wù)器發(fā)送此響應(yīng)以指示客戶端使用與先前請求相同的方法將請求的資源獲取到另一個URI。它具有與302 Found
HTTP響應(yīng)代碼相同的語義,但用戶代理不能更改所使用的HTTP方法:如果POST
在第一個請求POST
中使用了a,則必須在第二個請求中使用a 。308 Permanent Redirect
這意味著資源現(xiàn)在永久地位于由Location:
HTTP響應(yīng)頭指定的另一個URI 。它具有與301 Moved Permanently
HTTP響應(yīng)代碼相同的語義,但用戶代理不能更改所使用的HTTP方法:如果POST
在第一個請求POST
中使用了a,則必須在第二個請求中使用a 。
400 Bad Request
此響應(yīng)意味著由于語法無效,服務(wù)器無法理解請求。401 Unauthorized
盡管HTTP標(biāo)準(zhǔn)指定了“未授權(quán)”,但在語義上這個響應(yīng)意味著“未認(rèn)證”。也就是說,客戶端必須進(jìn)行身份驗證才能獲得請求的響應(yīng)。402 Payment Required
此答復(fù)代碼保留供將來使用。創(chuàng)建此代碼的初始目標(biāo)是將其用于數(shù)字支付系統(tǒng),但目前尚未使用。403 Forbidden
客戶端沒有對內(nèi)容的訪問權(quán)限,即他們未經(jīng)授權(quán),因此服務(wù)器拒絕給予適當(dāng)?shù)捻憫?yīng)。與401不同,客戶端的身份對服務(wù)器是已知的。404 Not Found
服務(wù)器找不到請求的資源。在瀏覽器中,這意味著URL不被識別。在API中,這也意味著端點(diǎn)有效,但資源本身不存在。服務(wù)器也可能發(fā)送此響應(yīng)而不是403來隱藏未授權(quán)客戶端的資源。這個響應(yīng)代碼可能是最著名的一個,因為它在網(wǎng)上頻繁發(fā)生。405 Method Not Allowed
請求方法由服務(wù)器知道,但已被禁用且無法使用。例如,API可能禁止刪除資源。這兩個強(qiáng)制性方法,GET
并且HEAD
,絕不能被禁用,不應(yīng)返回該錯誤代碼。406 Not Acceptable
當(dāng)執(zhí)行服務(wù)器驅(qū)動的內(nèi)容協(xié)商后,Web服務(wù)器發(fā)送此響應(yīng),沒有找到任何符合用戶代理標(biāo)準(zhǔn)的內(nèi)容。407 Proxy Authentication Required
這與401類似,但需要通過代理進(jìn)行身份驗證。408 Request Timeout
這個響應(yīng)在一些服務(wù)器的空閑連接上發(fā)送,即使客戶端沒有任何先前的請求。這意味著服務(wù)器想要關(guān)閉這個未使用的連接。由于Chrome,F(xiàn)irefox 27+或IE9等瀏覽器使用HTTP預(yù)連接機(jī)制加快瀏覽速度,因此使用此響應(yīng)的次數(shù)更多。另請注意,某些服務(wù)器僅在不發(fā)送此消息的情況下關(guān)閉連接。409 Conflict
當(dāng)請求與服務(wù)器的當(dāng)前狀態(tài)沖突時,會發(fā)送此響應(yīng)。410 Gone
如果所請求的內(nèi)容已從服務(wù)器中徹底刪除,并且沒有轉(zhuǎn)發(fā)地址,則會發(fā)送此響應(yīng)??蛻粜枰獎h除他們的緩存和資源鏈接。HTTP規(guī)范旨在將此狀態(tài)碼用于“限時促銷服務(wù)”。API不應(yīng)強(qiáng)迫使用此狀態(tài)代碼指示已刪除的資源。411 Length Required
服務(wù)器拒絕了請求,因為Content-Length
頭字段沒有被定義并且服務(wù)器需要它。412 Precondition Failed
客戶端已經(jīng)在服務(wù)器不符合的標(biāo)題中指出了前提條件。413 Payload Too Large
請求實(shí)體大于服務(wù)器定義的限制; 服務(wù)器可能會關(guān)閉連接或返回一個Retry-After
標(biāo)題字段。414 URI Too Long
客戶端請求的URI比服務(wù)器愿意解釋的更長。415 Unsupported Media Type
所請求數(shù)據(jù)的媒體格式不受服務(wù)器支持,因此服務(wù)器拒絕該請求。請求中標(biāo)題字段416 Requested Range Not Satisfiable
指定的范圍Range
不能滿足; 范圍可能超出目標(biāo)URI數(shù)據(jù)的大小。417 Expectation Failed
該響應(yīng)碼意味著Expect
服務(wù)器無法滿足請求頭字段指示的期望值。418 I'm a teapot
服務(wù)器拒絕嘗試用茶壺沖泡咖啡。421 Misdirected Request
該請求針對的是無法產(chǎn)生響應(yīng)的服務(wù)器。這可以由服務(wù)器發(fā)送,該服務(wù)器未配置為針對包含在請求URI中的方案和權(quán)限的組合產(chǎn)生響應(yīng)。422 Unprocessable Entity
(WebDAV)請求格式良好,但由于語義錯誤無法遵循。423 Locked
(WebDAV)被訪問的資源被鎖定。424 Failed Dependency
(WebDAV)由于先前請求失敗,請求失敗。426 Upgrade Required
服務(wù)器拒絕使用當(dāng)前協(xié)議執(zhí)行請求,但可能在客戶機(jī)升級到不同協(xié)議后愿意這樣做。服務(wù)器Upgrade
在426響應(yīng)中發(fā)送標(biāo)題以指示所需的協(xié)議。428 Precondition Required
原始服務(wù)器要求該請求是有條件的。旨在防止“丟失更新”問題,即客戶端獲取資源狀態(tài),修改該狀態(tài)并將其返回服務(wù)器,同時第三方修改了服務(wù)器上的狀態(tài),導(dǎo)致沖突。429 Too Many Requests
用戶在給定的時間內(nèi)發(fā)送了太多請求(“限速”)。431 Request Header Fields Too Large
服務(wù)器不愿意處理請求,因為它的頭部字段太大。請求可以在減小請求頭字段的大小后重新提交。451 Unavailable For Legal Reasons
用戶請求非法資源,例如由政府審查的網(wǎng)頁。
500 Internal Server Error
服務(wù)器遇到了它不知道如何處理的情況。501 Not Implemented
請求方法不受服務(wù)器支持,無法處理。服務(wù)器需要支持的唯一方法(因此不能返回此代碼)是GET
和HEAD
。502 Bad Gateway
這個錯誤響應(yīng)意味著服務(wù)器作為一個網(wǎng)關(guān)來處理請求所需的響應(yīng),得到了無效的響應(yīng)。503 Service Unavailable
服務(wù)器沒有準(zhǔn)備好處理請求。常見原因是服務(wù)器因維護(hù)或重載而停機(jī)。請注意,與此響應(yīng)一起,應(yīng)發(fā)送解釋問題的用戶友好頁面。這種反應(yīng)應(yīng)該用于臨時條件和Retry-After:
如果可能的話,HTTP頭應(yīng)該包含恢復(fù)服務(wù)之前的估計時間。網(wǎng)站管理員還必須注意與此響應(yīng)一起發(fā)送的與緩存相關(guān)的標(biāo)頭,因為這些臨時條件響應(yīng)通常不應(yīng)被緩存。504 Gateway Timeout
當(dāng)服務(wù)器充當(dāng)網(wǎng)關(guān)并且無法及時得到響應(yīng)時,會給出此錯誤響應(yīng)。505 HTTP Version Not Supported
請求中使用的HTTP版本不受服務(wù)器支持。506 Variant Also Negotiates
服務(wù)器有一個內(nèi)部配置錯誤:對請求的透明內(nèi)容協(xié)商導(dǎo)致循環(huán)引用。507 Insufficient Storage
服務(wù)器有內(nèi)部配置錯誤:所選的變體資源被配置為參與透明內(nèi)容協(xié)商本身,因此不是協(xié)商過程中的適當(dāng)端點(diǎn)。508 Loop Detected
(WebDAV)服務(wù)器在處理請求時檢測到無限循環(huán)。510 Not Extended
服務(wù)器需要對請求進(jìn)一步擴(kuò)展才能實(shí)現(xiàn)它。511 Network Authentication Required
511狀態(tài)碼指示客戶端需要進(jìn)行身份驗證才能獲得網(wǎng)絡(luò)訪問權(quán)限。