Hvordan setter du statuskoder og headere?

Question

Accepted Answer

FastAPI returnerer `200 OK` som standard, men du kontrollerer **statuskoden** (via dekoratøren eller response-objektet) og **headere** når du trenger annen oppførsel — viktig for riktig REST-semantikk.

## Angi en standardstatuskode på ruten

```python
from fastapi import status

@app.post("/items", status_code=status.HTTP_201_CREATED)   # 201 for resource creation
def create_item(item: Item):
    return item                                             # returns with 201

@app.delete("/items/{id}", status_code=status.HTTP_204_NO_CONTENT)  # 204
def delete_item(id: int):
    ...
```

`status_code`-dekoratørparameteren angir standardsuksessstatusen. Bruk av `status`-konstanter (f.eks. `status.HTTP_201_CREATED`) er klarere enn magiske tall. Riktige koder er viktige: `201` for opprettet, `204` for ingen innhold, osv.

## Dynamiske statuskoder og headere via Response-objektet

```python
from fastapi import Response

@app.get("/items/{id}")
def get_item(id: int, response: Response):
    item = db.get(id)
    if not item:
        response.status_code = status.HTTP_404_NOT_FOUND   # set dynamically
        return {"error": "not found"}
    response.headers["X-Custom"] = "value"                  # set a custom header
    return item
```

Injisering av en `Response`-parameter lar deg angi statuskode og headere **betinget** under kjøring.

## Feil: opphev HTTPException

```python
from fastapi import HTTPException

@app.get("/items/{id}")
def get_item(id: int):
    item = db.get(id)
    if not item:
        raise HTTPException(status_code=404, detail="Item not found",
                            headers={"X-Error": "NotFound"})   # status + detail + headers
    return item
```

For feilresponser er `raise HTTPException(...)` den idiomatiske måten — den angir statusen, en JSON `detail`-melding og valgfrie headere.

## Returner et tilpasset Response direkte

```python
from fastapi.responses import JSONResponse
return JSONResponse(content={...}, status_code=202, headers={"X-Custom": "v"})
```

## Hvorfor det er viktig

Riktige statuskoder og headere er essensielt for å bygge korrekte, veloppførte REST API-er — klienter og verktøy stoler på standard HTTP-semantikk (201 for opprettet, 404 for ikke funnet, 204 for ingen innhold, osv.), så å returnere riktig kode er del av en kvalitet API-kontrakt.

FastAPI gir deg ren kontroll: en standard `status_code` på ruten for det vanlige tilfellet, det injiserbare `Response`-objektet for dynamiske koder/headere, og `HTTPException` som den idiomatiske måten å signalisere feil med riktig status og en JSON-detalj.

Å forstå disse mekanismene — og bruke `status`-konstanter for klarhet — er hverdagskunnskap for å bygge API-er som oppfører seg riktig og kommuniserer klart med deres forbrukere.