Si e përcaktoni routes (operacionet e shtegut)?

Question

Accepted Answer

Në FastAPI, një **path operation** është një route — një funksion i dekoruar me një dekorues të metodës HTTP (`@app.get`, `@app.post`, etj.) që trajtojn kërkesat në një shteg. Vlera e kthyer e funksionit serializohet automatikisht në JSON.

## Përcaktimi i routes për secilin metodë 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}
```

Sëcili dekorues harton një metodë HTTP + shteg në një menaxhues. Emri i funksionit është juaj; dekoruesit përcakton route-në. Fjalorët/listat/Pydantic modelet e kthyer serializohen automatikisht në JSON — nuk ka nevojë për `json.dumps` manual.

## Renditja ka rëndësi për shteget e mbivendosjes

```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 përputhen routes në rendin e deklarimit, pra vendosni shteget statikë para atyre dinamike.

## Metadata e operacionit (shtys dokumentacionin)

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

Parametrat e dekoruesit (`tags`, `summary`, `status_code`, `response_model`) konfiguroni sjelljen dhe pasuroni dokumentacionin e gjeneruar automatikisht.

## Pse ka rëndësi

Operacionet e shtegut janë themeli i çdo aplikacioni FastAPI — ato përcaktojnë përfundimet e API-t tuaj dhe si trajtohen kërkesat.

Përtej dekoruesi-për-metodën-HTTP, që vlerat e kthyera serializohen automatikisht në JSON (pa boilerplate), që type hints në parametra drejtojnë konvertimin dhe validimin, dhe që renditja e route-s ka rëndësi për shteget e mbivendosjes, është njohuri thelbore për ndërtimin e çdo përfundimi.

Metadata e dekoruesit gjithashtu ushqen dokumentacionin automatik të FastAPI, lidhur routes direkt me dokumentacionin.

Kjo është gjëja e parë dhe më thelbore për të zotëruar në FastAPI.