আপনি কীভাবে 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 ত্রুটি সহ) এবং একটি টাইপড অবজেক্ট দেয়, যা অন্যান্য ফ্রেমওয়ার্কগুলির জন্য প্রয়োজনীয় ক্লান্তিকর, ত্রুটি-প্রবণ ম্যানুয়াল পার্সিং এবং যাচাইকরণকে দূর করে।

যাচাইকরণ একটি মূল **নিরাপত্তা/শক্তিশালীতা** সুবিধাও — বিকৃত ইনপুট আপনার লজিকে পৌঁছানোর আগে প্রত্যাখ্যান করা হয়।

বডি মডেল সংজ্ঞায়িত করতে কীভাবে, FastAPI স্বয়ংক্রিয়ভাবে বডি এবং পাথ/কোয়েরি পরামিতিগুলিকে কীভাবে আলাদা করে এবং আংশিক আপডেটের জন্য `exclude_unset` এর মতো প্যাটার্নগুলি বোঝা যেকোনো রাইট এন্ডপয়েন্ট তৈরির জন্য মৌলিক দৈনন্দিন জ্ঞান।