Hvordan indstiller du statuskoder og headere?

Question

Accepted Answer

FastAPI returnerer `200 OK` som standard, men du styrer **statuskoden** (via decoratoren eller response-objektet) og **headers**, når du har brug for anden adfærd — vigtig for korrekt REST-semantik.

## Indstilling af standard statuskode 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):
    ...
```

Decorator-parameteren `status_code` indstiller standard-successtatusen. Brug af `status`-konstanter (f.eks. `status.HTTP_201_CREATED`) er klarere end magiske tal. Korrekte koder betyder noget: `201` for oprettet, `204` for intet indhold osv.

## Dynamiske statuskoder og headers 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
```

Injection af en `Response`-parameter lader dig indstille statuskoden og headers **betinget** ved runtime.

## Fejl: Raise 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 fejlrespons er `raise HTTPException(...)` den idiomatiske måde — den indstiller status, en JSON `detail`-besked og valgfrie headers.

## Returnering af custom Response direkte

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

## Hvorfor det betyder noget

Korrekte statuskoder og headers er afgørende for at bygge korrekte, velmenende REST API'er — klienter og værktøjer stoler på standard HTTP-semantik (`201` for oprettet, `404` for ikke fundet, `204` for intet indhold osv.), så returnering af den rigtige kode er del af en kvalitets-API-kontrakt.

FastAPI giver dig ren kontrol: en standard `status_code` på ruten for det almindelige tilfælde, det injicerbare `Response`-objekt for dynamiske koder/headers, og `HTTPException` som den idiomatiske måde at signalere fejl med den relevante status og en JSON-detalje.

Forståelse af disse mekanismer — og brug af `status`-konstanter for klarhed — er hverdagsviden for at bygge API'er, der opfører sig korrekt og kommunikerer tydeligt med deres forbrugere.