Miten määrität reitit (polun operaatiot)?

Question

Accepted Answer

FastAPI:ssa **polun operaatio** on reitti — HTTP-menetelmän dekoraattorilla (`@app.get`, `@app.post` jne.) koristeltu funktio, joka käsittelee pyynnöt reitille. Funktion palautusarvo sarjoitetaan automaattisesti JSON-muotoon.

## Reittien määrittäminen jokaiselle HTTP-menetelmälle

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

Jokainen dekoraattori yhdistää HTTP-menetelmän + reitin käsittelijään. Funktion nimi on sinun; dekoraattori määrittää reitin. Palautetut sanakirjat/listat/Pydantic-mallit sarjoitetaan automaattisesti JSON-muotoon — ei manuaalista `json.dumps`.

## Järjestys on tärkeä päällekkäisille reiteille

```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 yhteensovittaa reitit ilmoitusjärjestyksessä, joten laita staattiset reitit ennen dynaamisia.

## Operaation metatiedot (ohjaa dokumentaatiota)

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

Dekoraattoriparametrit (`tags`, `summary`, `status_code`, `response_model`) konfiguroivat käyttäytymisen ja rikastuttavat automaattisesti luotua dokumentaatiota.

## Miksi se on tärkeää

Polun operaatiot ovat jokaisen FastAPI-sovelluksen perusta — ne määrittävät API:si päätepisteistä ja kuinka pyyntöjä käsitellään.

Dekoraattori-HTTP-menetelmä-mallin ymmärtäminen, että palautusarvot sarjoitetaan automaattisesti JSON-muotoon (ilman ylimääräistä koodia), että parametrien tyyppivihkeet ohjaavat muunnosta ja validointia, ja että reitin järjestys on tärkeä päällekkäisille reiteille on olennaista päivittäistä tietoa minkä tahansa päätepisteen rakentamiseen.

Dekoraattorimetatiedot syöttävät myös FastAPI:n automaattista dokumentaatiota ja yhdistävät reitit suoraan dokumentaatioon.

Tämä on ensimmäinen ja perustavanlaatuisin asia, joka on hallittava FastAPI:ssa.