আপনি কীভাবে রুট সংজ্ঞায়িত করেন (পাথ অপারেশন)?

Question

Accepted Answer

FastAPI-তে, একটি **পাথ অপারেশন** একটি রুট — একটি HTTP মেথড ডেকোরেটর (`@app.get`, `@app.post`, ইত্যাদি) দিয়ে সজ্জিত একটি ফাংশন যা একটি পাথে অনুরোধ পরিচালনা করে। ফাংশনের রিটার্ন ভ্যালু স্বয়ংক্রিয়ভাবে JSON-এ সিরিয়ালাইজ করা হয়।

## প্রতিটি HTTP মেথডের জন্য রুট সংজ্ঞায়িত করা

```python
from fastapi import FastAPI
app = FastAPI()

@app.get("/items")                # GET /items
def list_items():
    return [{"id": 1}, {"id": 2}]  # dict/list → automatically JSON-serialized

@app.get("/items/{item_id}")      # GET /items/5 — path parameter
def get_item(item_id: int):        # type hint converts "5" → int (and validates)
    return {"id": item_id}

@app.post("/items")               # POST /items
def create_item(item: Item):
    return item

@app.put("/items/{item_id}")      # PUT, PATCH, DELETE work the same way
@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    return {"deleted": item_id}
```

প্রতিটি ডেকোরেটর একটি HTTP মেথড + পাথকে একটি হ্যান্ডলারের সাথে ম্যাপ করে। ফাংশনের নাম আপনার; ডেকোরেটর রুট সংজ্ঞায়িত করে। রিটার্ন করা dict/list/Pydantic মডেল স্বয়ংক্রিয়ভাবে JSON-এ সিরিয়ালাইজ করা হয় — কোনো ম্যানুয়াল `json.dumps` প্রয়োজন নেই।

## ওভারল্যাপিং পাথের জন্য ক্রম গুরুত্বপূর্ণ

```python
@app.get("/users/me")            # ✅ specific route FIRST
def read_me(): ...
@app.get("/users/{user_id}")     # dynamic AFTER — else "me" matches {user_id}
def read_user(user_id: int): ...
```

FastAPI ঘোষণার ক্রমে রুট ম্যাচ করে, তাই স্ট্যাটিক পাথ ডায়নামিকের আগে রাখুন।

## অপারেশন মেটাডেটা (ডক চালিত করে)

```python
@app.get("/items", tags=["items"], summary="List items", status_code=200)
def list_items(): ...
```

ডেকোরেটর প্যারামিটার (`tags`, `summary`, `status_code`, `response_model`) আচরণ কনফিগার করে এবং স্বয়ংক্রিয়ভাবে তৈরি ডকুমেন্টেশনকে সমৃদ্ধ করে।

## এটি কেন গুরুত্বপূর্ণ

পাথ অপারেশন প্রতিটি FastAPI অ্যাপ্লিকেশনের ভিত্তি — তারা আপনার API-র এন্ডপয়েন্ট এবং অনুরোধ কীভাবে পরিচালনা করা হয় তা সংজ্ঞায়িত করে।

প্রতিটি HTTP মেথডের জন্য ডেকোরেটর প্যাটার্ন বোঝা, যে রিটার্ন ভ্যালু স্বয়ংক্রিয়ভাবে JSON-এ সিরিয়ালাইজ করা হয় (কোনো বয়লারপ্লেট নেই), যে প্যারামিটারের টাইপ হিন্ট রূপান্তর এবং যাচাইকরণ চালিত করে, এবং যে রুট অর্ডার ওভারল্যাপিং পাথের জন্য গুরুত্বপূর্ণ তা প্রতিদিনের জ্ঞান যা যেকোনো এন্ডপয়েন্ট তৈরির জন্য অপরিহার্য।

ডেকোরেটর মেটাডেটা FastAPI-র স্বয়ংক্রিয় ডকুমেন্টেশনও খাওয়ায়, রুটকে সরাসরি ডকের সাথে সংযুক্ত করে।

এটি FastAPI-তে প্রথম এবং সবচেয়ে মৌলিক জিনিস যা আয়ত্ত করতে হবে।