Hvordan definerer du ruter (path operations)?

Question

Accepted Answer

I FastAPI er en **path operation** en rute — en funksjon dekorert med en HTTP-metode-dekorator (`@app.get`, `@app.post`, osv.) som håndterer forespørsler til en sti. Returverdien til funksjonen serialiseres automatisk til JSON.

## Definere 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 dekorator kartlegger en HTTP-metode + sti til en handler. Funksjonsnavn er ditt; dekoratøren definerer ruten. Returnerte dicts/lister/Pydantic-modeller serialiseres automatisk til JSON — ingen manuell `json.dumps`.

## Rekkefølge er viktig 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 deklarasjonsrekkefølge, så plasser statiske stier før dynamiske.

## Operasjonsmetadata (driver dokumentasjonen)

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

Dekorator-parametere (`tags`, `summary`, `status_code`, `response_model`) konfigurerer oppførsel og beriker den autogenererte dokumentasjonen.

## Hvorfor det er viktig

Path operations er grunnlaget for hver FastAPI-applikasjon — de definerer APIets endepunkter og hvordan forespørsler håndteres.

Å forstå dekorator-per-HTTP-metode-mønsteret, at returverdier automatisk serialiseres til JSON (ingen boilerplate), at typehint-er på parametere driver konvertering og validering, og at ruterekkefølge er viktig for overlappende stier, er essensiell hverdagskunnskap for å bygge et hvilket som helst endepunkt.

Dekorator-metadataene tilfører også FastAPI's automatiske dokumentasjon, og knytter ruter direkte til dokumentene.

Dette er det første og mest grunnleggende å mestre i FastAPI.