Status Codes चुनना

वर्ग बताता है ग़लती किसकी है

Status codes पहले अंक से समूहित हैं: 2xx सफलता, 3xx redirect या "not modified", 4xx client से ग़लती हुई, 5xx server विफल हुआ। सटीक codes उपयोग करें: 200 OK, बनाने के बाद 201 Created (Location header के साथ), काम पृष्ठभूमि में जारी रहे तब 202 Accepted, बिना body की सफलता के लिए 204 No Content, ग़लत बने input के लिए 400 Bad Request, 401 Unauthorized (authenticated नहीं), 403 Forbidden (authenticated पर अनुमति नहीं), 404 Not Found, 409 Conflict (स्थिति का टकराव, जैसे दोहराव), 412 Precondition Failed (विफल conditional request), 422 Unprocessable Content (सही बना पर अमान्य डेटा), 429 Too Many Requests (Retry-After के साथ) और 503 Service Unavailable। Body के भीतर error छिपाकर कभी 200 न लौटाएँ: clients, caches और monitors code पर निर्भर करते हैं।

क्या हुआ, स्पष्ट बताएँ

Status codes, error bodies और pagination वह जगह हैं जहाँ API या तो भरोसेमंद लगता है या उलझन भरा।

घटना से status code, चलाकर

मैंने यह सादा-Python उदाहरण चलाया। छोटा lookup जिसे आप टीम के संदर्भ के रूप में उपयोग कर सकते हैं: created 201, async के लिए स्वीकार 202, deleted 204, validation 422, conflict 409, rate limited 429।

import hmac, hashlib, json, time, bisect

def status_for(event):
    return {"created": 201, "accepted_async": 202, "deleted": 204, "validation": 422, "conflict": 409, "not_found": 404, "unauth": 401, "forbidden": 403, "rate": 429}[event]
print([status_for(e) for e in ("created", "accepted_async", "deleted", "validation", "conflict", "rate")])

Output:

[201, 202, 204, 422, 409, 429]

401 बनाम 403

401 का मतलब "मुझे नहीं पता आप कौन हैं" (ग़ायब या ग़लत credentials); 403 का मतलब "मैं जानता हूँ आप कौन हैं और आप यह नहीं कर सकते"। इन्हें मिलाना clients को उलझाता है और bugs छिपाता है।

त्वरित जाँच: User logged in है पर उसे किसी कार्य की अनुमति नहीं। कौन-सा code ठीक है?

• 401 Unauthorized
• 403 Forbidden
• 200 OK
• 500 Internal Server Error