Hur definierar du routes (path operations)?

Question

Accepted Answer

I FastAPI är en **path operation** en route — en funktion dekorerad med en HTTP-metod-dekorator (`@app.get`, `@app.post`, osv.) som hanterar förfrågningar till en väg. Funktionens returvärde serialiseras automatiskt till JSON.

## Definiera routes för varje HTTP-metod

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

Varje dekorator mappar en HTTP-metod + väg till en hanterare. Funktionsnamnet är ditt; dekoratorn definierar routen. Returnerade dicts/listor/Pydantic-modeller serialiseras automatiskt till JSON — ingen manuell `json.dumps`.

## Ordningen spelar roll för överlappande vägar

```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 matchar routes i deklarationsordning, så placera statiska vägar före dynamiska.

## Operationsmetadata (driver dokumentationen)

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

Dekorator-parametrar (`tags`, `summary`, `status_code`, `response_model`) konfigurerar beteende och berikar den auto-genererade dokumentationen.

## Varför det spelar roll

Path operations är grunden för varje FastAPI-applikation — de definierar din API:s slutpunkter och hur förfrågningar hanteras.

Att förstå dekoratör-per-HTTP-metod-mönstret, att returvärden automatiskt serialiseras till JSON (utan boilerplate), att typkvinningar på parametrar driver konvertering och validering, och att rutordningen spelar roll för överlappande vägar är väsentlig vardaglig kunskap för att bygga någon slutpunkt.

Dekorator-metadatan matar också FastAPI:s automatiska dokumentation, vilket binder routes direkt till dokumentationen.

Detta är det första och viktigaste att bemästra i FastAPI.