Sapakah cara nampa badan panjalukan JSON?

Question

Accepted Answer

Kanggo nampa badan panjalukan JSON ing FastAPI, sampeyan nyatakake parameter fungsi kang dipilih minangka **modèl Pydantic**. FastAPI maca badan, ngurai JSON, ngesahake marang modèl, lan ngirim sampeyan obyek kang dipilih — kanthi otomatis.

## Dene iki penting

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

Nyatakake `item: Item` ngomong marang FastAPI kanggo maca badan panjalukan minangka JSON, ngurai menyang `Item`, lan **ngesahake** — fungsi sampeyan nampa obyek kang dipilih lan sah. Input sing ala ditolak kanthi otomatis:

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

## Badan + jalur + pitakon bebarengan

```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 kanthi cerdas ngrouting parameter: placeholder jalur → parameter jalur, modèl Pydantic → badan panjalukan, parameter kang dipilih kanthi basik → parameter pitakon.

## Parameter badan sawetara / pembaruan sebagian

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

## Dene iki penting

Namepa lan ngesahake badan panjalukan iku penting — meh kabeh API kang nggawe utawa nngobah data butuh iku, lan FastAPI nggawe iku luar biasa resik: nyatakake parameter modèl Pydantic menehi sampeyan ngurai JSON otomatis, **ngesahake** lengkap (kanthi kesalahan 422 tingkat lapangan sing jelas), lan obyek kang dipilih, ngilangke ngurai manual kang membosankan lan rawan kesalahan lan ngesahake sing framework liyane butuh.

Ngesahake uga manfaat **keamanan/ketangguhan** kunci — input kang wujud salah ditolak sadurunge tekan logika sampeyan.

Ngerteni carane nemtokake modèl badan, carane FastAPI ngiwa-ngenia badan saka parameter jalur/pitakon kanthi otomatis, lan pola-pola kaya `exclude_unset` kanggo pembaruan sebagian iku ngelmu dina-dinane sing dhasar kanggo mbangun endpoint penulisan apa wae.