HTTP Status Codes

यह किसके लिए है?

HTTP status codes तीन-digit संख्याएं हैं जो server client को बताने के लिए वापस भेजता है कि request कैसा गया। वे पांच families में group होते हैं: 1xx (informational), 2xx (success), 3xx (redirection), 4xx (client error), 5xx (server error)। अधिकांश developers headline codes जानते हैं — 200, 301, 404, 500 — लेकिन long tail (409 Conflict, 422 Unprocessable, 504 Gateway Timeout) वही जगह है जहां असली bugs रहते हैं। यह tool आपको अर्थों और RFC के साथ पूरी list देता है जहां प्रत्येक defined है।

कब इस्तेमाल करें

• एक API doc पढ़ रहे हैं जो आपको ज्ञात नहीं ऐसा code return करता है (425? 451?)।
• अपने API से return करने के लिए सही code चुनना — 404 vs 410, 401 vs 403, 422 vs 400।
• एक 502/504 का diagnose करना — क्या upstream down है या बस धीमा?
• तय करना कि 200-with-an-error-body या एक असली 4xx सही move है।
• एक code review या design doc के लिए RFC reference देखना।

आम गलतियाँ

• 401 का अर्थ unauthenticated है, 403 का अर्थ unauthorized है। नाम भ्रामक हैं — 401 कहता है "मुझे नहीं पता आप कौन हैं", 403 कहता है "मुझे पता है आप कौन हैं और आपके पास यह नहीं हो सकता"। 403 का उपयोग केवल तब करें जब re-authentication मदद नहीं करेगा।
• 302 method-ambiguous है। Browsers historically 302 redirect पर POST→GET बदल देते थे। Explicit होने के लिए 307 (method preserve करता है) या 303 (हमेशा GET) का उपयोग करें।
• 404, 410 नहीं है। 404 = "मुझे नहीं पता"; 410 = "मुझे पता है और यह हमेशा के लिए चला गया"। 410 तब उपयोग करें जब search engines को URL drop करना चाहिए।
• 200 error body के साथ "RESTful" नहीं है। यदि request resource level पर fail हुआ, तो body में error के साथ 4xx return करें।
• 418 एक joke है। production में I'm-a-teapot का उपयोग न करें — clients और proxies इसे inconsistently treat करते हैं।
• RFC 9110, RFC 7231/7232/7233/7234/7235 का स्थान लेता है। यदि आप spec cite कर रहे हैं, तो 9110 (June 2022) का उपयोग करें जब तक आपको विशेष रूप से पुराने version की आवश्यकता न हो।