HTTP 狀態碼

HTTP 狀態碼表明一個 HTTP 要求是否已經被完成。回應分為五種:

  1. 資訊回應 (Informational responses, 100199),
  2. 成功回應 (Successful responses, 200299),
  3. 重定向 (Redirects, 300399),
  4. 用戶端錯誤 (Client errors, 400499),
  5. 伺服器端錯誤 (Server errors, 500599).

以下的狀態碼定義在 section 10 of RFC 2616 中。你可以在 RFC 7231 查看更新過的規範。

備註: 如果你收到任何不在清單內的回應,那很可能伺服器自行軟體實作的非標準規範。

資訊回應

100 Continue

此臨時回應表明,目前為止的一切完好,而用戶端應當繼續完成請求、或是在已完成請求的情況下,忽略此資訊。

101 Switching Protocol

此狀態碼乃為用戶端 Upgrade (en-US) 請求標頭發送之回應、且表明伺服器亦切換中。

102 Processing (en-US) (WebDAV (en-US))

此狀態碼表明伺服器收到並處理請求中,但目前未有回應。

103 Early Hints (en-US)

此狀態碼主要與 Link (en-US) 標頭有關:它能讓用戶代理(user agent)能在伺服器準備回應前能 preloading (en-US) 資源。

成功回應

200 OK

請求成功。成功的意義依照 HTTP 方法而定: GET:資源成功獲取並於訊息主體中發送。 HEAD:entity 標頭已於訊息主體中。 POST:已傳送訊息主體中的 resource describing the result of the action。 TRACE:伺服器已接收到訊息主體內含的請求訊息。

201 Created

請求成功且新的資源成功被創建,通常用於 POST 或一些 PUT 請求後的回應。

202 Accepted

此請求已經被接受但尚未處理。此狀態為非承諾性,代表 HTTP 無法在之後傳送一個非同步的回應告知請求的處理結果。最初目的為外部程序或其他伺服器處理請求的情況,或用於批次處理中。

203 Non-Authoritative Information

此回應碼表示回傳的中介資料集與並非與原始伺服器上的有效確定集合完全相同,而是來自本地或第三方的副本。除此情況外,200 OK 回應碼應該被優先使用。

204 No Content

There is no content to send for this request, but the headers may be useful. The user-agent may update its cached headers for this resource with the new ones.

205 Reset Content

This response code is sent after accomplishing request to tell user agent reset document view which sent this request.

206 Partial Content

This response code is used because of range header sent by the client to separate download into multiple streams.

207 Multi-Status (en-US) (WebDAV (en-US))

A Multi-Status response conveys information about multiple resources in situations where multiple status codes might be appropriate.

208 Already Reported (en-US) (WebDAV (en-US))

Used inside a <dav:propstat> response element to avoid repeatedly enumerating the internal members of multiple bindings to the same collection.

226 IM Used (en-US) (HTTP Delta encoding)

The server has fulfilled a GET request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance.

重定向訊息

300 Multiple Choice

請求擁有一個以上的回應。用戶代理或使用者應該從中選一。不過,並沒有標準的選擇方案。

301 Moved Permanently

此回應碼的意思是,請求資源的 URI 已被改變。有時候,會在回應內給予新的 URI。

302 Found (en-US)

This response code means that URI of requested resource has been changed temporarily. New changes in the URI might be made in the future. Therefore, this same URI should be used by the client in future requests.

303 See Other (en-US)

Server sent this response to directing client to get requested resource to another URI with an GET request.

304 Not Modified (en-US)

This is used for caching purposes. It is telling to client that response has not been modified. So, client can continue to use same cached version of response.

305 Use Proxy 已棄用

在舊版本的 HTTP 規範中,表示請求資源必須透過代理存取。基於對代理的頻內設置 (in-band configuration) 相關的安全考量,該狀態碼已棄用。

306 unused

該狀態碼已不再被使用,僅被保留。該狀態碼曾在先前得的 HTTP 1.1 規範中被使用。

307 Temporary Redirect (en-US)

伺服器發送此回應來使客戶端保持請求方法不變向新的地址發出請求。 與 302 Found 相同,差別在於客戶端不許變更請求方法。例如,應使用另一個 POST 請求來重複發送 POST 請求。

308 Permanent Redirect (en-US)

This means that the resource is now permanently located at another URI, specified by the Location: HTTP Response header. This has the same semantics as the 301 Moved Permanently HTTP response code, with the exception that the user agent must not change the HTTP method used: if a POST was used in the first request, a POST must be used in the second request.

用戶端錯誤回應

400 Bad Request

此回應意味伺服器因為收到無效語法,而無法理解請求。

401 Unauthorized (en-US)

需要授權以回應請求。它有點像 403,但這裡的授權,是有可能辦到的。

402 Payment Required (en-US) 實驗性質

此回應碼留作未來使用。一開始此碼旨在用於數位交易系統,然而,目前極少被使用,且不存在標準或慣例。

403 Forbidden

用戶端並無訪問權限,例如未被授權,所以伺服器拒絕給予應有的回應。不同於 401,伺服端知道用戶端的身份。

404 Not Found

伺服器找不到請求的資源。因為在網路上它很常出現,這回應碼也許最為人所悉。

405 Method Not Allowed (en-US)

伺服器理解此請求方法,但它被禁用或不可用。有兩個強制性方法:GETHEAD,永遠不該被禁止、也不該回傳此錯誤碼。

406 Not Acceptable (en-US)

This response is sent when the web server, after performing server-driven content negotiation (en-US), doesn't find any content following the criteria given by the user agent.

407 Proxy Authentication Required (en-US)

類似於 401,但需要被代理伺服器驗證。.

408 Request Timeout (en-US)

This response is sent on an idle connection by some servers, even without any previous request by the client. It means that the server would like to shut down this unused connection. This response is used much more since some browsers, like Chrome, Firefox 27+, or IE9, use HTTP pre-connection mechanisms to speed up surfing. Also note that some servers merely shut down the connection without sending this message.

409 Conflict

表示請求與伺服器目前狀態衝突

410 Gone (en-US)

當伺服器已刪除請求的內容時會送出此回應。

411 Length Required

伺服器拒絕該請求,因為 Content-Length 頭沒有被定義,然而伺服器要求。

412 Precondition Failed (en-US)

The client has indicated preconditions in its headers which the server does not meet.

413 Payload Too Large (en-US)

請求的實體資料大小超過了伺服器定義的上限,伺服器會關閉連接或返回一個 Retry-After 回應頭。

414 URI Too Long (en-US)

客戶端的 URI 請求超過伺服器願意解析的長度。

415 Unsupported Media Type

被請求資源的多媒體類型不被伺服器支援,因此該請求被拒絕。

416 Requested Range Not Satisfiable (en-US)

The range specified by the Range header field in the request can't be fulfilled; it's possible that the range is outside the size of the target URI's data.

417 Expectation Failed (en-US)

此回應代表伺服器未能滿足請求標頭的Expect欄位所提出的期望回應。

418 I'm a teapot

The server refuses the attempt to brew coffee with a teapot.

421 Misdirected Request (en-US)

The request was directed at a server that is not able to produce a response. This can be sent by a server that is not configured to produce responses for the combination of scheme and authority that are included in the request URI.

422 Unprocessable Entity (en-US) (WebDAV (en-US))

請求格式正確,但有部分語意上的錯誤而無法執行請求。

423 Locked (en-US) (WebDAV (en-US))

被訪問的資源被鎖定。

424 Failed Dependency (en-US) (WebDAV (en-US))

由於先前的請求失敗導致此請求失敗。

426 Upgrade Required (en-US)

The server refuses to perform the request using the current protocol but might be willing to do so after the client upgrades to a different protocol. The server sends an Upgrade (en-US) header in a 426 response to indicate the required protocol(s).

428 Precondition Required (en-US)

The origin server requires the request to be conditional. Intended to prevent the 'lost update' problem, where a client GETs a resource's state, modifies it, and PUTs it back to the server, when meanwhile a third party has modified the state on the server, leading to a conflict.

429 Too Many Requests (en-US)

用戶在給定的時間內 ("rate limiting") 發送了過多的請求。

431 Request Header Fields Too Large (en-US)

伺服器不願意處理該請求,因為標頭欄位過大。該請求可能可以在減少請求標頭欄位大小後重新提交。

用戶端請求違法的資源,例如受政府審查的網頁。

伺服器端錯誤回應

500 Internal Server Error

伺服器端發生未知或無法處理的錯誤。

501 Not Implemented (en-US)

伺服器不支援請求的方法,僅有GETHEAD是伺服器必須支援的方法。

502 Bad Gateway

作為閘道的伺服器,在獲取處理請求所需的回應時,得到無效回應。

503 Service Unavailable

The server is not ready to handle the request. Common causes are a server that is down for maintenance or that is overloaded. Note that together with this response, a user-friendly page explaining the problem should be sent. This responses should be used for temporary conditions and the Retry-After: HTTP header should, if possible, contain the estimated time before the recovery of the service. The webmaster must also take care about the caching-related headers that are sent along with this response, as these temporary condition responses should usually not be cached.

504 Gateway Timeout

伺服器作為閘道器時無法及時得到回應。

505 HTTP Version Not Supported (en-US)

請求使用的 HTTP 版本不被伺服器支援。

506 Variant Also Negotiates (en-US)

The server has an internal configuration error: transparent content negotiation for the request results in a circular reference.

507 Insufficient Storage (en-US)

The server has an internal configuration error: the chosen variant resource is configured to engage in transparent content negotiation itself, and is therefore not a proper end point in the negotiation process.

508 Loop Detected (en-US) (WebDAV (en-US))

伺服器處理請求時偵測到無限迴圈。

510 Not Extended (en-US)

伺服器需要對請求做進一步的擴充才能完成請求。

511 Network Authentication Required (en-US)

用戶需要經過認證才能取得網路存取權。

瀏覽器相容性

BCD tables only load in the browser

參見