तपाईले routes (path operations) कसरी परिभाषित गर्नुहुन्छ?

Question

Accepted Answer

FastAPI मा, एक **path operation** एक route हो — एक HTTP method decorator (`@app.get`, `@app.post`, आदि) को साथ सजिएको function जसले path मा requests को सम्भाल गर्छ। Function को return value स्वचालित रूपमा JSON मा serialize हुन्छ।

## प्रत्येक HTTP method को लागि routes परिभाषित गर्दै

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

प्रत्येक decorator एक HTTP method + path को handler मा map गर्छ। Function को नाम तपाईको हो; decorator ले route परिभाषित गर्छ। Returned dicts/lists/Pydantic models स्वचालित रूपमा JSON मा serialize हुन्छन् — कुनै manual `json.dumps` छैन।

## Overlapping paths को लागि क्रम महत्त्वपूर्ण छ

```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 declaration order मा routes match गर्छ, त्यसैले static paths लाई dynamic ones भन्दा पहिले राख्नुहोस्।

## Operation metadata (docs को लागि ड्राइभ गर्छ)

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

Decorator parameters (`tags`, `summary`, `status_code`, `response_model`) व्यवहार को कन्फिगर गर्छ र auto-generated documentation को समृद्ध गर्छ।

## किन यो महत्त्वपूर्ण छ

Path operations प्रत्येक FastAPI application को आधार हुन् — तिनीहरूले तपाईको API को endpoints र requests कसरी सम्भाल गरिन्छ भनेर परिभाषित गर्छन्।

Decorator-per-HTTP-method pattern, कि return values स्वचालित रूपमा JSON मा serialize हुन्छन् (कुनै boilerplate छैन), कि parameters मा type hints conversion र validation लाई ड्राइभ गर्छन्, र overlapping paths को लागि route order महत्त्वपूर्ण छ भन्ने कुरा बुझ्नु कुनै पनि endpoint बनाउनको लागि दैनिक आवश्यक ज्ञान हो।

Decorator metadata पनि FastAPI को automatic documentation लाई खुवाउछ, routes लाई सीधै docs मा जोडदै।

यो FastAPI मा सिखने पहिलो र सबैभन्दा मौलिक कुरा हो।