Kako definirate rute (path operations)?

Question

Accepted Answer

U FastAPI-ju, **path operation** je ruta — funkcija dekorirana sa HTTP metodom dekorator (`@app.get`, `@app.post`, itd.) koja obrađuje zahtjeve na putanju. Povratna vrijednost funkcije automatski se serijalizira u JSON.

## Definiranje ruta za svaku HTTP metodu

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

Svaki dekorator mapira HTTP metodu + putanju na handler. Ime funkcije je vaše; dekorator definira rutu. Vraćeni dicts/liste/Pydantic modeli se automatski serijaliziraju u JSON — nema ručnog `json.dumps`.

## Red je bitan za preklapajuće putanje

```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 poklanja rute redoslijedom deklaracije, pa stavite statičke putanje prije dinamičnih.

## Metapodaci operacije (napajaju dokumentaciju)

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

Parametri dekoratora (`tags`, `summary`, `status_code`, `response_model`) konfiguriraju ponašanje i obogaćuju automatski generirane dokumentacije.

## Zašto je to važno

Path operations su temelj svake FastAPI aplikacije — definiraju krajnje točke vaše API-je i kako se zahtjevi obrađuju.

Razumijevanje obrasca dekorator-po-HTTP-metodi, da se povratne vrijednosti automatski serijaliziraju u JSON (bez šablone), da type hintsovi na parametrima upravljaju konverzijom i validacijom, i da red ruta važan za preklapajuće putanje je bitna svakodnevna znanja za izgradnju bilo kojeg krajnje točke.

Metapodaci dekoratora također hrane FastAPI-jevu automatsku dokumentaciju, povezujući rute izravno s dokumentacijom.

Ovo je prvo i najosnovnije što trebate savladati u FastAPI-ju.