Bir JSON istek gövdesini nasıl alırsınız?

Question

Accepted Answer

FastAPI'de bir JSON istek gövdesini almak için, **Pydantic modeli** olarak yazılı bir işlev parametresi bildirirsiniz. FastAPI, gövdeyi okur, JSON'u ayrıştırır, modele karşı doğrular ve sizi yazılmış bir nesne ile sağlar — otomatik olarak.

## Desen

```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` bildirmek, FastAPI'ye istek gövdesini JSON olarak okumak, bunu bir `Item` olarak ayrıştırmak ve **doğrulamak** — işleviniz yazılmış, geçerli bir nesne alır. Hatalı giriş otomatik olarak reddedilir:

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

## Gövde + yol + sorgu birlikte

```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 parametreleri akıllıca yönlendirir: bir yol yer tutucu → yol parametresi, bir Pydantic modeli → istek gövdesi, basit yazılı bir parametre → sorgu parametresi.

## Birden fazla gövde parametresi / kısmi güncellemeler

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

## Neden önemli

İstek gövdesini almak ve doğrulamak gereklidir — veri oluşturan veya güncelleyen neredeyse her API buna ihtiyaç duyar ve FastAPI bunu dikkat çekici şekilde temiz kılar: bir Pydantic modeli parametresi bildirmek size otomatik JSON ayrıştırması, tam **doğrulama** (açık alan düzeyinde 422 hataları ile) ve yazılmış bir nesne sağlar ve bu, diğer çerçevelerin gerektirdiği sıkıcı, hataya eğilimli manuel ayrıştırma ve doğrulamayı ortadan kaldırır.

Doğrulama ayrıca **güvenlik/sağlamlık** için önemli bir faydadır — kötü biçimlendirilmiş giriş, mantığınıza ulaşmadan önce reddedilir.

Bir gövde modelini nasıl tanımlayacağınızı, FastAPI'nin gövdeyi yol/sorgu parametrelerinden otomatik olarak nasıl ayıracağını ve kısmi güncellemeler için `exclude_unset` gibi desenleri anlamak, herhangi bir yazma uç noktası oluştururken temel günlük bilgidir.