在API 中，常用的code碼

brianway 發(fā)布于2019-08-01 16:31 / 3150人閱讀

摘要：狀態(tài)碼解釋請求成功接收并處理，一般響應(yīng)中都會有請求已完成，并導(dǎo)致了一個或者多個資源被創(chuàng)建，最常用在創(chuàng)建資源的時候請求已經(jīng)接收并開始處理，但是處理還沒有完成。

狀態(tài)碼	Label	解釋
200	OK	請求成功接收并處理，一般響應(yīng)中都會有 body
201	Created	請求已完成，并導(dǎo)致了一個或者多個資源被創(chuàng)建，最常用在 POST 創(chuàng)建資源的時候
202	Accepted	請求已經(jīng)接收并開始處理，但是處理還沒有完成。一般用在異步處理的情況，響應(yīng) body 中應(yīng)該告訴客戶端去哪里查看任務(wù)的狀態(tài)
204	No Content	請求已經(jīng)處理完成，但是沒有信息要返回，經(jīng)常用在 PUT 更新資源的時候（客戶端提供資源的所有屬性，因此不需要服務(wù)端返回）。如果有重要的 metadata，可以放到頭部返回
301	Moved Permanently	請求的資源已經(jīng)永久性地移動到另外一個地方，后續(xù)所有的請求都應(yīng)該直接訪問新地址。服務(wù)端會把新地址寫在 Location 頭部字段，方便客戶端使用。允許客戶端把 POST 請求修改為 GET。
304	Not Modified	請求的資源和之前的版本一樣，沒有發(fā)生改變。用來緩存資源，和條件性請求（conditional request）一起出現(xiàn)
307	Temporary Redirect	目標(biāo)資源暫時性地移動到新的地址，客戶端需要去新地址進(jìn)行操作，但是不能修改請求的方法。
308	Permanent Redirect	和 301 類似，除了客戶端不能修改原請求的方法
400	Bad Request	客戶端發(fā)送的請求有錯誤（請求語法錯誤，body 數(shù)據(jù)格式有誤，body 缺少必須的字段等），導(dǎo)致服務(wù)端無法處理
401	Unauthorized	請求的資源需要認(rèn)證，客戶端沒有提供認(rèn)證信息或者認(rèn)證信息不正確
403	Forbidden	服務(wù)器端接收到并理解客戶端的請求，但是客戶端的權(quán)限不足。比如，普通用戶想操作只有管理員才有權(quán)限的資源。
404	Not Found	客戶端要訪問的資源不存在，鏈接失效或者客戶端偽造 URL 的時候回遇到這個情況
405	Method Not Allowed	服務(wù)端接收到了請求，而且要訪問的資源也存在，但是不支持對應(yīng)的方法。服務(wù)端必須返回 Allow 頭部，告訴客戶端哪些方法是允許的
415	Unsupported Media Type	服務(wù)端不支持客戶端請求的資源格式，一般是因?yàn)榭蛻舳嗽?Content-Type 或者 Content-Encoding中申明了希望的返回格式，但是服務(wù)端沒有實(shí)現(xiàn)。比如，客戶端希望收到 xml返回，但是服務(wù)端支持 Json
429	Too Many Requests	客戶端在規(guī)定的時間里發(fā)送了太多請求，在進(jìn)行限流的時候會用到
500	Internal Server Error	服務(wù)器內(nèi)部錯誤，導(dǎo)致無法完成請求的內(nèi)容
503	Service Unavailable	服務(wù)器因?yàn)樨?fù)載過高或者維護(hù)，暫時無法提供服務(wù)。服務(wù)器端應(yīng)該返回 Retry-After 頭部，告訴客戶端過一段時間再來重試