Jak definujete trasy (operace cesty)?

Question

Accepted Answer

V FastAPI je **operace cesty** trasa — funkce dekorovaná dekorátorem HTTP metody (`@app.get`, `@app.post` atd.), která zpracovává požadavky na cestu. Vrácená hodnota funkce je automaticky serializována do JSON.

## Definování tras pro každou 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}
```

Každý dekorátor mapuje HTTP metodu + cestu na obslužný program. Název funkce je na vás; dekorátor definuje trasu. Vrácené dict/list/Pydantic modely jsou automaticky serializovány do JSON — bez ručního `json.dumps`.

## Pořadí je důležité pro překrývající se cesty

```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 porovnává trasy v pořadí deklarace, takže umístěte statické cesty před dynamické.

## Metadata operace (řídí dokumenty)

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

Parametry dekorátoru (`tags`, `summary`, `status_code`, `response_model`) nakonfigurují chování a obohatí automaticky generovanou dokumentaci.

## Proč je to důležité

Operace cesty jsou základem každé aplikace FastAPI — definují koncové body vaší API a způsob zpracování požadavků.

Porozumění vzoru dekorátor-za-HTTP-metodu, že vrácené hodnoty jsou automaticky serializovány do JSON (bez boilerplate kódu), že typové nápovědy na parametrech řídí konverzi a validaci a že pořadí tras je důležité pro překrývající se cesty je zásadní každodenní znalost pro vytváření jakéhokoli koncového bodu.

Metadata dekorátoru také zajišťuje automatickou dokumentaci FastAPI a přímo spojuje trasy s dokumenty.

Toto je první a nejzákladnější věc, kterou je třeba zvládnout v FastAPI.