तपाईले JSON अनुरोध शरीर कसरी प्राप्त गर्नुहुन्छ?

Question

Accepted Answer

FastAPI मा JSON अनुरोध शरीर प्राप्त गर्न, तपाईले **Pydantic मडेल** को रूपमा टाइप गरिएको फ़ंक्शन प्यारामिटर घोषणा गर्नुहुन्छ। FastAPI ले शरीर पढ्छ, JSON को पार्स गर्छ, यसलाई मडेल विरुद्ध मान्य गर्छ, र तपाईलाई एक टाइप गरिएको वस्तु पास गर्छ — स्वचालित रूपमा।

## प्रतिरूप

```python
from pydantic import BaseModel

class Item(BaseModel):
    name: str
    price: float
    description: str | None = None      # optional field

@app.post("/items")
def create_item(item: Item):             # `item: Item` → read & validate the JSON body
    # `item` is a fully-validated Item object here
    return {"name": item.name, "total": item.price * 1.1}
```

```json
// request body the client sends:
{ "name": "Phone", "price": 999.0 }
```

`item: Item` घोषणा गर्दा FastAPI लाई अनुरोध शरीर को JSON को रूपमा पढ्न, यसलाई `Item` मा पार्स गर्न, र **मान्य गर्न** भन्छ — तपाईको फ़ंक्शन एक टाइप गरिएको, मान्य वस्तु प्राप्त गर्छ। खराब इनपुट स्वचालित रूपमा अस्वीकृत छ:

```json
// POST { "name": "Phone" }  (missing price) → automatic 422:
{ "detail": [{ "loc": ["body", "price"], "msg": "field required" }] }
```

## शरीर + पथ + क्वेरी सँगै

```python
@app.put("/items/{item_id}")
def update(item_id: int, item: Item, notify: bool = False):
    # item_id = path param, item = JSON body (Pydantic model), notify = query param
    # FastAPI distinguishes them by type/location automatically
```

FastAPI बुद्धिमत्तापूर्वक प्यारामिटरहरु मार्ग गर्छ: पथ प्लेसहोल्डर → पथ प्यारामिटर, Pydantic मडेल → अनुरोध शरीर, साधारण-टाइप गरिएको प्यारामिटर → क्वेरी प्यारामिटर।

## एकाधिक शरीर प्यारामिटरहरु / आंशिक अपडेटहरु

```python
@app.patch("/items/{id}")
def patch(id: int, item: ItemUpdate):       # use a model with all-optional fields for PATCH
    update_data = item.model_dump(exclude_unset=True)   # only fields the client sent
```

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

अनुरोध शरीरहरु प्राप्त गर्न र मान्य गर्न आवश्यक छ — लगभग हरेक API जो डेटा सृजना वा अपडेट गर्छ यसको आवश्यकता छ, र FastAPI यसलाई उल्लेखनीय रूपमा स्वच्छ बनाउछ: Pydantic-मडेल प्यारामिटर घोषणा गर्दा तपाईलाई स्वचालित JSON पार्सिङ, पूर्ण **मान्यता** (स्पष्ट फील्ड-स्तरीय 422 त्रुटिहरु सँग), र एक टाइप गरिएको वस्तु दिन्छ, जसले अन्य ढाँचाहरु आवश्यक गर्ने कठिन, त्रुटि-प्रवण म्यानुएल पार्सिङ र मान्यता समाप्त गर्छ।

मान्यता पनि एक मुख्य **सुरक्षा/दृढता** लाभ हो — खराब ढाँचा गरिएको इनपुट तपाईको तर्क पहुँचने अघि अस्वीकृत हुन्छ।

शरीर मडेल परिभाषित गर्न कसरी, FastAPI ले कसरी शरीर लाई पथ/क्वेरी प्यारामिटरहरु बाट स्वचालित रूपमा भेद गर्छ, र आंशिक अपडेटहरु को लागि `exclude_unset` जस्ता प्रतिरूपहरु बुझ्न कुनै पनि लेखन अन्तबिन्दु निर्माण गर्न आवश्यक दैनिक ज्ञान हो।