როგორ იღებთ JSON მოთხოვნის 본문?

Question

Accepted Answer

JSON მოთხოვნის bod-ის მისაღებად FastAPI-ში, თქვენ დეკლარირებთ ფუნქციის პარამეტრს, რომელიც აკრეფილია როგორც **Pydantic მოდელი**. FastAPI კითხულობს body-ს, აანალიზებს 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-ს, რომ წაიკითხოს მოთხოვნის body JSON-ად, გააანალიზოს `Item`-ში და **ადასტუროს** — თქვენი ფუნქცია იღებს აკრეფილ, სწორ ობიექტს. ცუდი input ავტომატურად უარყოფილია:

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

## Body + path + query ერთად

```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 ინტელიგენტურად მარშრუტშებს პარამეტრებს: path placeholder → path param, Pydantic მოდელი → მოთხოვნის body, მარტივი-აკრეფილი პარამეტრი → query param.

## რამდენიმე body პარამეტრი / ნაწილობრივი განახლებები

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

## რატომ არის ეს მნიშვნელოვანი

მოთხოვნის body-ის მიღება და დასტურება აუცილებელია — თითქმის ყველა API, რომელიც აქმნის ან აახალიანებს მონაცემებს ამას სჭირდება, და FastAPI ამას აკეთებს საოცრად სუფთად: Pydantic-მოდელის პარამეტრის დეკლარირება გაძლევთ ავტომატური JSON ანალიზას, სრულ **დასტურებას** (რომელიც აკეთებს ნათელ field-level 422 შეცდომებს) და აკრეფილ ობიექტს, რომელიც აღმოფხვრის მოსაბეზრო, შეცდომით მდგომ ხელით ანალიზას და დასტურებას, რომელიც სხვა ჩარჩოები მოითხოვს.

დასტურება ასევე არის **უსაფრთხოება/სიმყარე** სარგებელი — უხარი input უარყოფილია თქვენი ლოგიკაში მიღწევამდე.

historia body მოდელის განსაზღვრის, როგორ ამჯობინებს FastAPI body-ს path/query პარამეტრებისგან ავტომატურად, და ნიმუშები, როგორიცაა `exclude_unset` ნაწილობრივი განახლებებისთვის, არის ფუნდამენტური ყოველდღიური ცოდნა ნებისმიერი write endpoint-ის აგებისთვის.