200 |
OK |
請求成功接收並處理,通常響應中都會有 body |
201 |
Created |
請求已完成,並致使了一個或者多個資源被建立,最經常使用在 POST 建立資源的時候 |
202 |
Accepted |
請求已經接收並開始處理,可是處理尚未完成。通常用在異步處理的狀況,響應 body 中應該告訴客戶端去哪裏查看任務的狀態 |
204 |
No Content |
請求已經處理完成,可是沒有信息要返回,常常用在 PUT 更新資源的時候(客戶端提供資源的全部屬性,所以不須要服務端返回)。若是有重要的 metadata,能夠放到頭部返回 |
301 |
Moved Permanently |
請求的資源已經永久性地移動到另一個地方,後續全部的請求都應該直接訪問新地址。服務端會把新地址寫在 Location 頭部字段,方便客戶端使用。容許客戶端把 POST 請求修改成 GET。 |
304 |
Not Modified |
請求的資源和以前的版本同樣,沒有發生改變。用來緩存資源,和條件性請求(conditional request)一塊兒出現 |
307 |
Temporary Redirect |
目標資源暫時性地移動到新的地址,客戶端須要去新地址進行操做,可是不能修改請求的方法。 |
308 |
Permanent Redirect |
和 301 相似,除了客戶端不能修改原請求的方法 |
400 |
Bad Request |
客戶端發送的請求有錯誤(請求語法錯誤,body 數據格式有誤,body 缺乏必須的字段等),致使服務端沒法處理 |
401 |
Unauthorized |
請求的資源須要認證,客戶端沒有提供認證信息或者認證信息不正確 |
403 |
Forbidden |
服務器端接收到並理解客戶端的請求,可是客戶端的權限不足。好比,普通用戶想操做只有管理員纔有權限的資源。 |
404 |
Not Found |
客戶端要訪問的資源不存在,連接失效或者客戶端僞造 URL 的時候回遇到這個狀況 |
405 |
Method Not Allowed |
服務端接收到了請求,並且要訪問的資源也存在,可是不支持對應的方法。服務端必須返回 Allow 頭部,告訴客戶端哪些方法是容許的 |
415 |
Unsupported Media Type |
服務端不支持客戶端請求的資源格式,通常是由於客戶端在 Content-Type 或者 Content-Encoding中申明瞭但願的返回格式,可是服務端沒有實現。好比,客戶端但願收到 xml返回,可是服務端支持 Json |
429 |
Too Many Requests |
客戶端在規定的時間裏發送了太多請求,在進行限流的時候會用到 |
500 |
Internal Server Error |
服務器內部錯誤,致使沒法完成請求的內容 |
503 |
Service Unavailable |
服務器由於負載太高或者維護,暫時沒法提供服務。服務器端應該返回 Retry-After 頭部,告訴客戶端過一段時間再來重試 |