? REST API – HTTP Methods
? 10大REST API常見問題?
1xx Informational/信息
這一系列狀態(tài)代碼表示信息內(nèi)容。這意味著已收到請求并正在處理中。以下是常用的信息狀態(tài)代碼:
100 Continue/繼續(xù):
此代碼表示服務(wù)器已收到請求標頭,客戶端現(xiàn)在可以發(fā)送正文內(nèi)容。在這種情況下,客戶端首先發(fā)出請求(使用Expect:100-continue標頭),以檢查它是否可以從部分請求開始。然后,服務(wù)器可以響應(yīng)100繼續(xù)(OK)或417期望失敗(否)以及適當?shù)脑颉?/p>
101 Switching Protocols/交換協(xié)議:
此代碼表示服務(wù)器可以處理來自客戶端的協(xié)議交換機請求。
102 Processing/處理:
此代碼是一個信息狀態(tài)代碼,用于長期運行處理,以防止客戶端超時。這告訴客戶等待未來的響應(yīng),該響應(yīng)將具有實際響應(yīng)主體。
2xx Success/成功
這一系列狀態(tài)代碼表示請求的成功處理。本類中一些常用的狀態(tài)代碼如下:
200 OK/確定:
此代碼表示請求成功,響應(yīng)內(nèi)容已酌情返回給客戶端。
201 Created/創(chuàng)建:
此代碼表示請求成功,并創(chuàng)建了新資源。
204 No Content/無內(nèi)容:
此代碼表示請求已成功處理,但此請求沒有返回值。例如,您可能會找到此類狀態(tài)代碼來響應(yīng)資源的刪除。
3xx Redirection/重定向
這一系列狀態(tài)代碼表明,客戶端需要執(zhí)行進一步的操作,以在邏輯上結(jié)束請求。本類中常用的狀態(tài)代碼如下:
304 Not Modified/未修改:
此狀態(tài)表示自上次訪問以來,該資源沒有被修改過。僅當客戶端通過將請求標頭設(shè)置為If-Modified-Since或If-None-Match時允許時,才會返回此代碼。客戶可以根據(jù)此狀態(tài)代碼采取適當行動。
4xx Client Error/客戶端錯誤
這一系列狀態(tài)代碼表示處理請求時出錯。本類中一些常用的狀態(tài)代碼如下:
400 Bad Request/不良請求:
此代碼表示服務(wù)器由于請求中的語法格式錯誤而無法處理請求。客戶端可以在更正請求后再試一次。
401 Unauthorized/未經(jīng)授權(quán):
此代碼表示資源需要身份驗證。客戶端可以使用適當?shù)纳矸蒡炞C再次嘗試。
403 Forbidden/禁止:
此代碼表示服務(wù)器拒絕響應(yīng)請求,即使請求有效。如果請求不是HEAD方法,原因?qū)⒘性谡膬?nèi)容中。
404 Not Found/未找到:
此代碼表示在請求中指定的位置找不到請求的資源。
405 Method Not Allowed/方法不允許:
此代碼表示請求中指定的HTTP方法不允許在URI標識的資源上使用。
408 Request Timeout/請求超時:
此代碼表示客戶端未能在服務(wù)器上設(shè)置的時間窗口內(nèi)響應(yīng)。
409 Conflict/沖突:
此代碼表示請求無法完成,因為它與在資源上建立的一些規(guī)則沖突,例如驗證失敗。
5xx Server Error/服務(wù)器錯誤
此系列狀態(tài)代碼表示在處理有效請求時服務(wù)器故障。以下是本類中常用的狀態(tài)代碼之一:
500 Internal Server Error/內(nèi)部服務(wù)器錯誤:
此代碼指示通用錯誤消息,并指示服務(wù)器上發(fā)生意外錯誤,請求無法完成。
501(Not Implemented/未實施):
服務(wù)器要么無法識別請求方法,要么無法滿足請求。通常,這意味著未來的可用性(例如,Web服務(wù)API的新功能)。
HTTP Status Codes匯總
1×× 信息
- 100 Continue/繼續(xù)
- 101 Switching Protocols/交換協(xié)議
- 102 Processing/處理
2×× 成功
- 200 OK/好
- 201 Created/創(chuàng)建
- 202 Accepted/接受
- 203 Non-authoritative Information/非權(quán)威信息
- 204 No Content/無內(nèi)容
- 205 Reset Content/重置內(nèi)容
- 206 Partial Content/部分內(nèi)容
- 207 Multi-Status/多狀態(tài)
- 208 Already Reported/已報告
- 226 IM Used/IM使用
3×× 重定向
- 300 Multiple Choices/多項選擇
- 301 Moved Permanently/永久移動
- 302 Found/找到
- 303 See Other/查看其他
- 304 Not Modified/未修改
- 305 Use Proxy/使用代理
- 307 Temporary Redirect/臨時重定向
- 308 Permanent Redirect/永久重定向
4××客戶端錯誤
- 400 Bad Request/錯誤請求
- 401 Unauthorized/未經(jīng)授權(quán)
- 402 Payment Required/需要付款
- 403 Forbidden/禁止
- 404 Not Found/未找到
- 405 Method Not Allowed/不允許方法
- 406 Not Acceptable/不可接受
- 407 Proxy Authentication Required/需要代理身份驗證
- 408 Request Timeout/請求超時
- 409 Conflict/沖突
- 410 Gone/走了
- 411 Length Required/所需長度
- 412 Precondition Failed/先決條件失敗
- 413 Payload Too Large/有效載荷太大
- 414 Request-URI Too Long/請求-URI太長
- 415 Unsupported Media Type/不受支持的媒體類型
- 416 Requested Range Not Satisfiable/請求的范圍不令人滿意
- 417 Expectation Failed/預(yù)期失敗
- 418 I’m a teapot/
- 421 Misdirected Request/誤導(dǎo)請求
- 422 Unprocessable Entity/不可處理實體
- 423 Locked/鎖定
- 424 Failed Dependency/依賴失敗
- 426 Upgrade Required/需要升級
- 428 Precondition Required/需要先決條件
- 429 Too Many Requests/請求太多
- 431 Request Header Fields Too Large/請求Header字段太大
- 444 Connection Closed Without Response/連接關(guān)閉,沒有響應(yīng)
- 451 Unavailable For Legal Reasons/因法律原因不可用
- 499 Client Closed Request/客戶已關(guān)閉請求
5××服務(wù)器錯誤
- 500 Internal Server Error/內(nèi)部服務(wù)器錯誤
- 501 Not Implemented/未實施
- 502 Bad Gateway/壞網(wǎng)關(guān)
- 503 Service Unavailable/服務(wù)不可用
- 504 Gateway Timeout/網(wǎng)關(guān)超時
- 505 HTTP Version Not Supported/不支持HTTP版本
- 506 Variant Also Negotiates/變體也進行談判
- 507 Insufficient Storage/存儲不足
- 508 Loop Detected/檢測到循環(huán)
- 510 Not Extended/未擴展
- 511 Network Authentication Required/需要網(wǎng)絡(luò)身份驗證
- 599 Network Connect Timeout Error/網(wǎng)絡(luò)連接超時錯誤
參考資料
原文: REST API – HTTP Status Codes
Mozilla HTTP 響應(yīng)狀態(tài)碼
表格化,更易讀的HTTP狀態(tài)碼
一站搜索、試用、比較全球API!
試用API,一次比較多個渠道