நீங்கள் JSON கோரிக்கை본문 ஐ எவ்வாறு பெறுகிறீர்கள்?

Question

Accepted Answer

FastAPI இல் JSON கோரிக்கை본문 ஐ பெற, **Pydantic மாதிரி** என தட்டசெய்யப்பட்ட ஒரு செயல்பாட்டு அளவுருவை அறிவிக்கவும். FastAPI본문 ஐ படிக்கிறது, 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 க்கு கோரிக்கை本文 ஐ JSON ஆக படிக்க, அதை `Item`ல் பிரிக்க, மற்றும் **சரிபார்க்க** சொல்கிறது — உங்கள் செயல்பாடு தட்டசெய்யப்பட்ட, செல்லுபடியாகும் பொருளைப் பெறுகிறது. மோசமான உள்ளீடு தானாக நிராகரிக்கப்படும்:

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

##본문 + பாதை + கேள்வி ஒன்றாக

```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 அறிவுடன் அளவுருக்களை மேலிட்ட செய்கிறது: ஒரு பாதை புரிதல்காரன் → பாதை அளவுரு, ஒரு Pydantic மாதிரி → கோரிக்கை本文, ஒரு எளிய-தட்டசெய்யப்பட்ட அளவுரு → கேள்வி அளவுரு.

## பல பாடி அளவுருக்கள் / பகுதி புதுப்பிப்புகள்

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

## இது ஏன் முக்கியம்

கோரிக்கை本文 ஐ பெற்று சரிபார்ப்பது அপরिहार्य — தரவை உருவாக்கும் அல்லது புதுப்பிக்கும் ஏறக்குறைய ஒவ்வொரு API க்கும் இதன் தேவை உள்ளது, மற்றும் FastAPI இதை குறிப்பிடத்தக்க அளவில் சுத்தமாக செய்கிறது: Pydantic-மாதிரி அளவுருவை அறிவிப்பது உங்களுக்கு தானாக JSON பிரிதல், முழு **சரிபார்ப்பு** (தெளிவான புல-நிலை 422 오류கள் கொண்டு), மற்றும் தட்டசெய்யப்பட்ட பொருளை கொடுக்கிறது, தொலைக்கு எளிமையற்ற, பிழை-경향 கையேடு பிரிதல் மற்றும் სხვა கাঠামோ요구する சரிபார்ப்பை நீக்குகிறது.

சரிபார்ப்பு **보안/견고함** நன்மை முக്கியமாகவும் உள்ளது — தவறாக உருவாக்கப்பட்ட உள்ளீடு உங்கள் logic ஐ அடைய முன் நிராகரிக்கப்படும்.

ஒரு本문 மாதிரிஐ எவ்வாறு வரையறுக்க, FastAPI பாதை/கேள்வி அளவுருக்களிலிருந்து automatically வேறுபடுத்த என்பதை புரிந்துகொள்ளல் மற்றும் பகுதி புதுப்பிப்புக்களுக்கு `exclude_unset` போன்ற வடிவங்கள் எந்த எழுதும் endpoint ஐ உருவாக்குவதற்கான அடிப்படை daily জ்ञान.