Hvordan definerer du ruter (stioperationer)?

Question

Accepted Answer

I FastAPI er en **stioperationen** en rute — en funktion dekoreret med en HTTP-metoddekoratør (`@app.get`, `@app.post` osv.), der håndterer anmodninger til en sti. Funktionens returværdi serialiseres automatisk til JSON.

## Definition af ruter for hver HTTP-metode

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

Hver dekoratør kortlægger en HTTP-metode + sti til en handler. Funktionsnavnet er dit; dekoratøren definerer ruten. Returnerede dicts/lists/Pydantic-modeller serialiseres automatisk til JSON — ingen manuel `json.dumps`.

## Rækkefølgen betyder noget for overlappende stier

```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 matcher ruter i deklarationsrækkefølge, så sæt statiske stier før dynamiske.

## Operationsmetadata (driver dokumentationen)

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

Dekoratørparametre (`tags`, `summary`, `status_code`, `response_model`) konfigurerer adfærd og beriger den autogenererede dokumentation.

## Hvorfor det betyder noget

Stioperationer er grundlaget for ethvert FastAPI-program — de definerer dine API-slutpunkter og hvordan anmodninger håndteres.

At forstå dekoratør-per-HTTP-metode-mønsteret, at returværdier automatisk serialiseres til JSON (ingen boilerplate), at typebetegnelser på parametre driver konvertering og validering, og at rutrækkefølgen betyder noget for overlappende stier er væsentlig daglig viden for at bygge ethvert slutpunkt.

Dekoratørmetadata fodrer også FastAPI's automatiske dokumentation og forbinder ruter direkte til dokumentationen.

Dette er det første og vigtigste at mestre i FastAPI.