Kako definirate route-e (path operations)?

Question

Accepted Answer

V FastAPI je **path operation** route — funkcija dekorirana s HTTP method dekorator (`@app.get`, `@app.post`, itd.), ki obdela zahteve na poti. Povratna vrednost funkcije se samodejno serializira v JSON.

## Definiranje route-ov za vsako HTTP metodo

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

Vsak dekorator preslika HTTP metodo + pot na obdelovalnik. Ime funkcije je vaše; dekorator definira route. Vrnjeni dicts/lists/Pydantic modeli se samodejno serializirajo v JSON — ni potrebno ročno `json.dumps`.

## Vrstni red je pomemben za prekrivajuće poti

```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 se uskladi s route-i v vrstnem redu deklaracije, zato statične poti postavite pred dinamične.

## Metadata operacije (poganja dokumentacijo)

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

Parametri dekoratorja (`tags`, `summary`, `status_code`, `response_model`) konfigurirajo vedenje in bogatijo samodejno generirano dokumentacijo.

## Zakaj je to pomembno

Path operations so temelj vsake FastAPI aplikacije — definirajo končne točke vašega API-ja in kako se obdelujejo zahteve.

Razumevanje pattern-a dekoratorja-na-HTTP-metodo, da se povratne vrednosti samodejno serializirajo v JSON (brez boilerplate-a), da type hints na parametrih poganjajo konverzijo in validacijo, in da je vrstni red route-ov pomemben za prekrivajuće poti, je bistvenega pomena za vsakdanje znanje gradnje katerega koli endpoint-a.

Metadata dekoratorja tudi napaja samodejno dokumentacijo FastAPI, povezujoč route-e neposredno s dokumentacijo.

To je prva in najpomembnejša stvar za obvladovanje v FastAPI.