首頁 / 開發者工具 / HTTP 狀態碼
參考

HTTP 狀態碼解析

使用此頁面快速了解回應碼代表什麼、問題出在用戶端或伺服器端,以及哪些代碼在偵錯和 API 工作中最重要。

最適合 API 偵錯與網頁回應初步排查可搭配 HTTP 狀態碼使用

狀態碼群組

1xx 資訊性

請求仍在進行中。這些在一般瀏覽器偵錯中不常見。

2xx 成功

請求成功。 200, 201,以及 204 最常出現。

3xx 重新導向

用戶端需要跟隨另一個 URL 或使用快取內容。

4xx 用戶端錯誤

請求無效、未經授權、缺少或受到速率限制。

5xx 伺服器錯誤

伺服器在處理有效請求時失敗。

你實際會用到的常見代碼

代碼意義典型情況
200OK一般成功的 GET 或 POST 回應
201已建立POST 後成功建立資源
301永久重新導向URL 已永久變更,請更新連結與標準網址目標
302找到暫時重新導向,通常用於登入或短期路由
400錯誤請求承載資料格式錯誤或缺少必要參數
401未經授權缺少或無效的認證
403禁止存取已驗證但無權存取此資源
404找不到路由、檔案或資源不存在
429請求過多已超過速率限制
500內部伺服器錯誤未處理的伺服器端失敗

快速除錯檢查清單

  • 若代碼為 4xx,請先檢查請求:驗證、payload 格式、URL、標頭。
  • 若狀態碼為 5xx,請先檢查伺服器與日誌。
  • 若狀態碼為 301 或 302,請確認重新導向的目的地,以及該行為是否符合預期。
  • 若狀態碼為 429,請加入重試邏輯或退避機制,而不是持續猛打端點。

請搭配合適工具使用此參考資料

相關工具