華為云計算 云知識 API接口狀態(tài)碼說明
API接口狀態(tài)碼說明

接口狀態(tài)碼是指在HTTP協(xié)議中,服務(wù)器響應(yīng)客戶端請求時返回的一個三位數(shù)字代碼,用于指示請求的結(jié)果。這些狀態(tài)碼分為幾個類別,每個類別代表不同的含義。下面是HTTP狀態(tài)碼的主要分類及其含義,隨后總結(jié)了一些常見的狀態(tài)碼:

  • 1xx 信息性狀態(tài)碼:表示請求已被接收,正在繼續(xù)處理。

  • 2xx 成功狀態(tài)碼:表示請求已成功被服務(wù)器接收、理解并處理。

  • 3xx 重定向狀態(tài)碼:表示需要客戶端采取進(jìn)一步的操作以完成請求。

  • 4xx 客戶端錯誤狀態(tài)碼:表示客戶端發(fā)送的請求包含錯誤或無法被服務(wù)器理解。

  • 5xx 服務(wù)器錯誤狀態(tài)碼:表示服務(wù)器在處理請求時發(fā)生了錯誤。

 

  • 常見狀態(tài)碼:
  • 200 OK:請求成功,通常返回的信息包含實體主體。
  • 201 Created:請求成功并且創(chuàng)建了一個新的資源。
  • 204 No Content:服務(wù)器已經(jīng)成功處理了請求,但沒有返回任何內(nèi)容。
  • 301 Moved Permanently:請求的資源已被永久移動到新的URI,返回的信息會包含新的URI。
  • 302 Found (Previously "Moved Temporarily"):請求的資源現(xiàn)在臨時位于不同的URI,返回的信息會包含新的URI。
  • 400 Bad Request:服務(wù)器無法理解請求的格式,客戶端不應(yīng)該重復(fù)提交這個請求。
  • 401 Unauthorized:請求需要用戶的身份認(rèn)證。
  • 403 Forbidden:服務(wù)器理解請求客戶端的請求,但是拒絕執(zhí)行此請求。
  • 404 Not Found:請求失敗,請求所希望得到的資源未被在服務(wù)器上發(fā)現(xiàn)。
  • 500 Internal Server Error:服務(wù)器遇到了一個未曾預(yù)料的情況,導(dǎo)致了它無法完成對請求的處理。
  • 503 Service Unavailable:服務(wù)器目前無法使用(由于超載或停機(jī)維護(hù))。
  • 504 Gateway Timeout:作為網(wǎng)關(guān)或者代理工作的服務(wù)器嘗試執(zhí)行請求時,未能及時從上游服務(wù)器接收到請求。

 

這些狀態(tài)碼是HTTP協(xié)議中最常用的部分,幫助客戶端和服務(wù)器之間進(jìn)行有效的通信,而且對于調(diào)試和診斷API問題非常有幫助。理解這些狀態(tài)碼后,可以使用CodeArts API開始您的API設(shè)計。CodeArts API是華為云API全生命周期管理 一體化解決方案平臺,支持開發(fā)者高效實現(xiàn)API設(shè)計、API開發(fā)、API測試、API托管、API運(yùn)維、API變現(xiàn)的一站式體驗。