Si si marrë një trup kërkese JSON?

Question

Accepted Answer

Për të marrë një trup kërkese JSON në FastAPI, deklaroni një parametër funksioni të shtypur si një **model Pydantic**. FastAPI lexon trupin, analizon JSON-in, e valido atë kundër modelit dhe ju duon një objekt të shtypur — automatikisht.

## Modeli

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

Deklarimi i `item: Item` i thotë FastAPI-t të lexojë trupin e kërkesës si JSON, ta analizojë në `Item` dhe ta **validojë** — funksioni juaj merr një objekt të vlefshëm të shtypur. Hyrja e këqija refuzohet automatikisht:

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

## Trupi + rruga + pyetje së bashku

```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 direkt rrugon parametrat: një zëvendësues rruge → parametër rruge, një model Pydantic → trup kërkese, një parametër i shtypur thjesht → parametër pyetjeje.

## Shumë parametra trupi / përditësime të pjesshme

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

## Pse ka rëndësi

Marrja dhe validimi i trupit të kërkesës është thelbësor — pothuajse çdo API që krijon ose përditëson të dhëna e ka nevojën, dhe FastAPI e bën atë jashtëzakonisht të pastër: deklarimi i një parametri modeli Pydantic ju jep analizim automatik JSON, validim të plotë (me gabime të qarta në nivel fushe 422) dhe një objekt të shtypur, duke eliminuar analizimin manual të lodhshëm, të prirur ndaj gabimeve dhe validimin që kërkojnë kuadro të tjerë.

Validimi është gjithashtu një përfitim kyç për **sigurinë/fortësinë** — hyrja e formuar gabimisht refuzohet përpara se të arrij logjikën tuaj.

Kuptimi se si të përcaktohet një model trupi, si FastAPI dallon automatikisht trupin nga parametrat e rrugës/pyetjeve dhe modelet si `exclude_unset` për përditësime të pjesshme është njohuri themelore e përditshme për ndërtimin e çdo pikë fundore të shkrimit.