Unawezaje kupokea mwili wa ombi la JSON?

Question

Accepted Answer

Ili kupokea mwili wa ombi la JSON katika FastAPI, unadeklareti parameter ya kazi iliyoandikwa kama **modeli ya Pydantic**. FastAPI inasoma mwili, inachanganua JSON, inakamatia kulingana na modeli, na inakupa kitu kilichoandikwa — otomati.

## Muundo

```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 }
```

Kudeklareti `item: Item` inasema FastAPI kusoma mwili wa ombi kama JSON, kuibadilisha kuwa `Item`, na **kukamatia** — kazi yako inapokea kitu kilichoandikwa, halali. Ingizo bovu linakataaliwa otomati:

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

## Mwili + njia + swali pamoja

```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 inaamrisha kwa akili vigezo: kishantazaji cha njia → kigezo cha njia, modeli ya Pydantic → mwili wa ombi, kigezo kilichoandikwa rahisi → kigezo cha swali.

## Vigezo vya mwili mwingi / sasisho za sehemu

```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
```

## Kwa nini inakadiriwa

Kupokea na kukamatia mwili wa ombi ni muhimu — karibu kila API inayounda au husasisha data inahitaji, na FastAPI inafanya kazi ya kusikitisha: kudeklareti kigezo cha modeli ya Pydantic inakupa uchambuzi wa JSON otomati, **kamatia** kamili (na hitilafu zenye maelezo mahususi ya ngazi ya 422) na kitu kilichoandikwa, inayoondoa uchambuzi wa mwanzo unaochubiliwa, wenye hitilafu na kamatia ambayo muundo mwingine unahitaji.

Kamatia pia ni faida muhimu ya **usalama/imara** — ingizo lenye hitilafu linakataaliwa kabla haijafika logic yako.

Kufahamu jinsi ya kufafanua modeli ya mwili, jinsi FastAPI tofautisha mwili kutoka kwa vigezo vya njia/swali otomati, na mifumo kama `exclude_unset` kwa sasisho za sehemu ni maarifa ya kimsingi ya kila siku kwa kujenga ncha yoyote ya kuandika.