HTTP Status Code
HTTP 狀態碼
HTTP 狀態碼是回應中的三位數字,用來說明請求的標準結果,以及它屬於哪一類結果。
另一個例子
匯入 API 還在處理時回傳 202 和狀態 URL;立即建立成功時回傳 201 與 `Location`;版本衝突回 409;CSV 欄位內容不合規則則回 422。JSON 問題內容可補充有用細節,但不會改變狀態碼的意思。
主要部分
- 01狀態類別
- 02已登記代碼
- 03回應中繼資料與內容
什麼時候用
回傳最符合結果的精確已登記狀態碼,並視需要加入有用的標頭和固定格式的錯誤內容。
什麼時候不要用
不要讓每個業務失敗都回傳 200,也不要用過度具體的錯誤洩漏敏感的授權資訊。
程式裡的名稱
1xx informational, 2xx success, 3xx redirection, 4xx client, 5xx server 上線前要檢查
檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。
預期成果:為這套系統設計或檢查 HTTP 狀態碼 (HTTP Status Code),並讓資料保持正確、安全且容易維護。 使用者情境:匯入 API 還在處理時回傳 202 和狀態 URL;立即建立成功時回傳 201 與 `Location`;版本衝突回 409;CSV 欄位內容不合規則則回 422。JSON 問題內容可補充有用細節,但不會改變狀態碼的意思。 技術概念或控制措施:HTTP 狀態碼 (HTTP Status Code)。 適用理由:回傳最符合結果的精確已登記狀態碼,並視需要加入有用的標頭和固定格式的錯誤內容。 不應使用的情況:不要讓每個業務失敗都回傳 200,也不要用過度具體的錯誤洩漏敏感的授權資訊。 工程要求:定義輸入、輸出、介面約定,以及任何情況都不能破壞的規則。說明授權與輸入檢查範圍。定義失敗、逾時、重試和重複執行只生效一次的規則。也要定義資料搬移與相容限制。 營運要求:加入監控訊號與隱藏敏感資料的記錄。設定容量上限並寫好操作手冊。測試復原與回復上一版的流程。 驗收條件:介面約定與失敗路徑測試通過。重試或部分失敗時,資料與授權規則仍正確。效能上限、監控、復原與回復上一版的方法都已驗證。 證據與限制(證據邊界):標準只涵蓋列出的範圍,不會替你決定外觀、產品做法或 Vibulary 的教學範例。 待確認:程式執行環境、資料位置、流量形態、資料一致需求和安全邊界。也要確認相容期間、服務目標(SLO)與回復上一版的限制。
檢查這份需求
請 AI 程式助手檢查目前如何使用 HTTP 狀態碼 (HTTP Status Code)。 定義:HTTP 狀態碼是回應中的三位數字,用來說明請求的標準結果,以及它屬於哪一類結果。 正式環境檢查:檢查介面約定、任何情況都不能破壞的規則、授權與輸入限制。測試重試、重複執行只生效一次、逾時與部分失敗。驗證資料完整性、相容性、監控、復原與回復上一版。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。