तुम मार्गांचे (पाथ ऑपरेशन) व्याख्या कशी करता?

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 मध्ये शिकण्याची पहिली आणि सर्वात मूलभूत गोष्ट आहे.