在API 中,經常使用的code碼

狀態碼 Label 解釋
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 頭部,告訴客戶端過一段時間再來重試
相關文章
相關標籤/搜索