HTTP Status Codes 工具是一個獨立、以瀏覽器為基礎的參考資料，收錄了 IANA HTTP Status Code Registry 中 64 個個別註冊項目，並於 2026 年七月 17 日擷取。由於每次查詢都在本機執行，不會發出網路請求、呼叫外部服務，也不會上傳搜尋文字，因此它可以作為 HTTP status codes API 的替代方案。開發者無需依賴會回傳相同描述字串的託管端點，只需開啟單一頁面，即可在瀏覽器中直接篩選 IANA 快照資料，讓隱私、速率限制和服務可用性不再是查詢流程的一環。表格依數值排序，包含每個代碼的回應類別、簡明釋義、註冊狀態，以及連結的 RFC 參考文件，方便交叉檢查哪些代碼仍被視為網際網路標準、哪些已被標記為已棄用、未使用或已過時。由於資料集是基於註冊表而非任何伺服器可能輸出的所有數字，因此刻意排除了廠商專屬的擴充與未指派的範圍，使參考資料與 IANA 快照保持一致，而非依附於特定框架的詮釋。
為什麼開發者會尋找 HTTP Status Codes API 的替代方案
外部的 HTTP status code API 與執行階段程式庫解決了一個反覆出現的問題：開發者需要快速確認 503、429 或 422 究竟代表什麼意思，而不必每次重新閱讀 RFC 9110。託管端點、含有硬式編碼列舉的 NPM 套件，以及特定語言的常數程式庫都有其用途，但每一種都會隨著團隊與時間累積摩擦成本。任何第三方服務都會套用速率限制，一旦查詢端點發生故障，就會連帶影響技術棧中其他無關部分的工具與測試。當新的暫時性註冊出現或代碼被重新分類時，常數程式庫會逐漸偏離 IANA 註冊表，導致真相來源分散在多個過時的套件版本中。各框架也會發布自己的代碼清單，這些清單常常包含並非網際網路標準的廠商專屬擴充，在該框架內雖然有用，但開發者使用通用參考資料時卻容易產生誤導。
以註冊表為優先的瀏覽器參考資料，透過將網路呼叫從查詢路徑中移除來解決這些痛點。搜尋在使用者的瀏覽器中對 IANA HTTP Status Code Registry 的內嵌快照進行，因此資料不會移動，開發者也不需要帳號、權杖或配額。其權衡在於資料集帶有快照日期，在該日期之後新增或重新分類的代碼將不會出現，直到快照更新為止。對於大多數查詢流程而言，這種權衡是可接受的，因為註冊表的變動緩慢，而且快照本身已明確標示，而非隱藏在會變動的 API 之後。
以瀏覽器為基礎的註冊表參考資料實際提供的內容
HTTP Status Codes 參考資料刻意縮小了範圍。它僅包含 IANA HTTP 狀態碼註冊表中目前列出的 64 個個別具名項目（從 100 到 511），除此之外別無其他。未指派的範圍是刻意排除的，以免語法上合法的三位數被誤標示為已註冊的標準。例如，數值 105 位於未指派的範圍內，因此對 105 的精確搜尋不會回傳任何資料列，且介面會顯示沒有符合的註冊項目。對於註冊表參考資料而言這是正確的行為，即使對曾在自訂框架中見過 105 的開發者來說可能會感到意外。
表格中的每一列都包含五項資訊：數值代碼、原因片語、回應類別、簡明的意義釋義，以及註冊狀態標籤。當代碼指向一份權威文件時，表格還會包含 RFC 參考文件，讓開發人員在更改實作行為之前能查閱相關的規範說明。對於任何歷經標準化程序的代碼而言，註冊狀態標籤至關重要：104 被標示為 Temporary（暫時），因為它繫結於一份進行中的 Internet-Draft；305 Use Proxy 被標示為已棄用；306 與 418 被標示為未使用；510 Not Extended 被標示為已過時。表格保留了這些項目，因為它們在註冊表中有明確的對應記錄，但標籤清楚表明它們不應作為新工作中的現行一般回應代碼。
如何在不呼叫 API 的情況下查詢狀態碼
若要在不呼叫外部 API 的情況下查詢 HTTP 狀態碼，請開啟 HTTP Status Codes 參考頁面並依照下列步驟操作：
- 在搜尋框中輸入精確的三位數代碼（例如 404）、類別模式（例如 4xx）、原因片語（例如 Not Found）、概念（例如 gateway），或協定詞彙（例如 WebDAV）。搜尋會檢查代碼、片語、類別、摘要、RFC 參考文件以及註冊狀態，因此部分相符與概念相符的效果與精確的數值查詢一樣好。
- 當您希望將比對範圍限制在某一百位數區間時，請從回應類別選擇器中選擇 Informational、Successful、Redirection、Client error 或 Server error。選擇器會與文字查詢結合，因此在 Server error 之下搜尋 gateway 僅會回傳與 gateway 相關的伺服器失敗，而在 Server error 之下搜尋 Not Found 則會產生明確的空白結果，而不會留下一張過時的表格。
- 閱讀篩選後每一列所保留的片語、簡明意義、註冊狀態標籤與 RFC 參考文件。請將簡明意義視為一種釋義，而非用來取代所引用的 RFC，因為精確的語意經常取決於請求方法、標頭、快取狀態、驗證情境、中介行為，或諸如 WebDAV 之類的擴充。
- 當實作細節影響互通性、安全性、快取或自動化重試行為時，請開啟連結的 RFC。這份連結的規範文件是判斷方法是否被允許、回應主體是否合於規範、快取應如何驗證，以及用戶端應如何回應的權威來源。
- 單獨將註冊狀態標籤作為一種篩選依據。當標籤顯示 Temporary、Deprecated、Unused 或 Obsolete 時，請將該代碼視為超出現行一般代碼集，並改用註冊表中其他位置所記錄的現行替代方案。
整個流程都在瀏覽器中執行。搜尋文字絕不會上傳到 Lizely 或任何其他服務，因此即使在受限制的網路、注重隱私的情境，以及限制對外 HTTP 流量的環境中，該工具依然可以使用。
五種回應類別與篩選機制
HTTP 回應代碼依第一位數字分為五個類別，參考頁面上的回應類別選擇器反映了這樣的分類。了解類別之間的界線，是精確搜尋與雜訊結果之間的差異所在。下表概述了 RFC 9110 所定義、並為本工具篩選邏輯所採用的結構。
| 類別 | 代碼範圍 | 一般意義 | 典型處置 |
|---|---|---|---|
| Informational | 100–199 | 最終回應之前的過渡性進度通知 | 繼續等待或送出請求的其餘部分 |
| Successful | 200–299 | 請求已接受、理解並處理 | 讀取回應主體或進行下一步 |
| Redirection | 300–399 | 需要採取進一步動作才能完成請求 | 依照 Location 標頭進行，或套用快取規則 |
| Client error | 400–499 | 因用戶端條件導致請求無法處理 | 檢查請求、修正輸入，或重新驗證身分 |
| Server error | 500–599 | 伺服器無法履行一個有效的請求 | 檢查伺服器記錄、以退避方式重試，或聯絡操作員 |
一個類別的涵蓋範圍比單一代碼更廣。404 Not Found 與 429 Too Many Requests 都屬於用戶端錯誤回應，但它們傳達的情境不同，通常需要不同的處置方式。當開發者正在除錯的是廣泛的失敗類別而非特定代碼時，依類別篩選是一種縮小搜尋範圍的方法。在搜尋框中輸入 4xx 會回傳用戶端錯誤類別中所有個別註冊的項目；它不會為未指派的數字捏造資料列，因此結果的數量會與該類別中已註冊代碼的數量一致，而非介於 400 與 499 之間所有可能值的合成計數。
「現行」以外的註冊狀態
將每個 HTTP 狀態碼都視為穩定的現行標準，是常見的錯誤來源。IANA 註冊表追蹤多種註冊狀態，表格將其以標籤形式呈現，讓開發者能一眼判斷某個代碼是否適合發送。Current（現行）代碼是任何符合規範的用戶端與伺服器都能依賴的日常數值。Temporary（暫時性）代碼（例如 104 Upload Resumption Supported）繫結於一份進行中的 Internet-Draft，可能在成為永久標準之前就過期或變更，因此在評估處於該狀態的代碼時，項目旁的快照日期便顯得重要。
Deprecated（已棄用）的項目在註冊表中仍保有記錄，但不再建議用於新工作。RFC 9110 將 305 Use Proxy 記錄為已棄用。Unused（未使用）的項目（例如 306 與 418）為保留狀態，並在註冊表中標示為 unused；與 418 連結的知名「I'm a teapot」片語並非 IANA 現行的描述，表格刻意顯示註冊表中的 unused 標籤，而非該文化性的片語。Obsolete（已過時）的項目（包括 510 Not Extended）僅供歷史參考保留，不應作為一般回應代碼使用。這些狀態各自代表一個訊號——應從現行代碼集中選擇其他代碼，而表格的標籤讓這項訊號無需額外研究即可一目了然。
當登錄項目參考無法診斷實際事件時
HTTP 狀態碼傳達的是通訊協定結果，並無法證明根本原因，而登錄項目參考也無法取代實際除錯作業。502 Bad Gateway 可能反映上游伺服器當機、網路路徑問題、代理伺服器逾時政策，或是上游輸出格式錯誤，而單一回應碼通常不足以區分這些情況。429 回應表示有速率限制，但其重試行為取決於特定服務，可能會使用 Retry-After 標頭來傳達等待時間。404 可能將受禁止的資源隱藏在通用的找不到回應之後，而 500 則刻意保持通用，以避免洩漏實作細節。
針對上述任何情況，HTTP 狀態碼工具說明的是已註冊的通訊協定意義，而非特定伺服器上的操作錯誤。請使用回應標頭、請求識別碼、伺服器記錄和相關服務文件，來判斷實際事件發生的真正原因。此工具不會聯絡 URL、檢查伺服器，也不會聲稱能識別執行階段錯誤，而這個界線正是它能作為穩定參考資料而非除錯工具的原因之一。若需要獨立且偏向實作面的交叉驗證，MDN 的 HTTP 回應狀態碼 參考資料是實用的輔助資源，但應與 IANA 快照一起閱讀，而非用來取代它。
如果您正在權衡各種方案，用於瀏覽器測試的 JavaScript Playground API 替代方案對此有詳細說明。
如果您正在權衡各種方案，如何使用 JavaScript 按鍵代碼查詢工具對此有詳細說明。