तपाइँ स्ट्याटस कोड र हेडरहरू कसरी सेट गर्नुहुन्छ?

Question

Accepted Answer

FastAPI पूर्वनिर्धारितमा `200 OK` फर्काउँछ, तर तपाइँ **स्ट्याटस कोड** (डेकोरेटर वा response वस्तु मार्फत) र **हेडरहरू** नियन्त्रण गर्नुहुन्छ जब तपाइँलाई फरक व्यवहार चाहिन्छ — यो उचित REST semantics को लागि महत्त्वपूर्ण छ।

## रुटमा पूर्वनिर्धारित स्ट्याटस कोड सेट गर्न

```python
from fastapi import status

@app.post("/items", status_code=status.HTTP_201_CREATED)   # 201 for resource creation
def create_item(item: Item):
    return item                                             # returns with 201

@app.delete("/items/{id}", status_code=status.HTTP_204_NO_CONTENT)  # 204
def delete_item(id: int):
    ...
```

`status_code` डेकोरेटर प्यारामिटर पूर्वनिर्धारित सफलता स्ट्याटस सेट गर्छ। `status` constants (जस्तै `status.HTTP_201_CREATED`) का प्रयोग जादुई संख्याहरूभन्दा स्पष्ट हुन्छ। सही कोडहरू महत्त्वपूर्ण हुन्छन्: `201` सिर्जनाको लागि, `204` कुनै सामग्री नभएको लागि, आदि।

## Response वस्तु मार्फत गतिशील स्ट्याटस कोड र हेडरहरू

```python
from fastapi import Response

@app.get("/items/{id}")
def get_item(id: int, response: Response):
    item = db.get(id)
    if not item:
        response.status_code = status.HTTP_404_NOT_FOUND   # set dynamically
        return {"error": "not found"}
    response.headers["X-Custom"] = "value"                  # set a custom header
    return item
```

`Response` प्यारामिटर inject गर्नुले तपाइँलाई स्ट्याटस कोड र हेडरहरू **सशर्त रूपमा** runtime मा सेट गर्न दिन्छ।

## त्रुटिहरू: HTTPException उठाउनुहोस्

```python
from fastapi import HTTPException

@app.get("/items/{id}")
def get_item(id: int):
    item = db.get(id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found",
                            headers={"X-Error": "NotFound"})   # status + detail + headers
    return item
```

त्रुटि प्रतिक्रियाहरूको लागि, `raise HTTPException(...)` idiomatic तरिका हो — यो स्ट्याटस, JSON `detail` सन्देश, र वैकल्पिक हेडरहरू सेट गर्छ।

## कस्टम Response सीधै फर्काउनु

```python
from fastapi.responses import JSONResponse
return JSONResponse(content={...}, status_code=202, headers={"X-Custom": "v"})
```

## यो किन महत्त्वपूर्ण छ

उचित स्ट्याटस कोडहरू र हेडरहरू सही, राम्रो-व्यवहार गरिएको REST APIs निर्माण गर्नको लागि आवश्यक हुन्छन् — ग्राहकहरू र उपकरणहरू मानक HTTP semantics (सिर्जनाको लागि 201, नभेटिएको लागि 404, कुनै सामग्री नभएको लागि 204, आदि) मा निर्भर हुन्छन्, त्यसैले सही कोड फर्काउनु गुणस्तरीय API अनुबन्धको अंश हो।

FastAPI तपाइँलाई स्पष्ट नियन्त्रण दिन्छ: सामान्य केसको लागि रुटमा पूर्वनिर्धारित `status_code`, गतिशील कोड/हेडरहरूको लागि injectable `Response` वस्तु, र त्रुटिहरू संकेत गर्नको लागि idiomatic तरिकाको रूपमा `HTTPException`।

यी संयन्त्रहरू बुझ्न — र स्पष्टताको लागि `status` constants प्रयोग गर्न — APIs निर्माण गर्नको लागि दैनिक ज्ञान हो जो सही रूपमा व्यवहार गर्छन् र तिनीहरूका ग्राहकहरूसँग स्पष्टतापूर्वक संवाद गर्छन्।