Hur anger du statuskoder och headers?

Question

Accepted Answer

FastAPI returnerar `200 OK` som standard, men du kontrollerar **statuskoden** (via dekoratorn eller response-objektet) och **headers** när du behöver annat beteende — viktigt för korrekt REST-semantik.

## Ange standardstatuskod på rutten

```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):
    ...
```

Dekorator-parametern `status_code` ställer in standard-framgångsstatus. Att använda `status`-konstanter (t.ex. `status.HTTP_201_CREATED`) är tydligare än magiska nummer. Rätt koder är viktiga: `201` för skapad, `204` för inget innehål, osv.

## Dynamiska statuskoder och 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
```

Att injicera en `Response`-parameter låter dig ange statuskod och headers **villkorligt** vid körning.

## Fel: 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
```

För felresponser är `raise HTTPException(...)` det idiomatiska sättet — det ställer in status, ett JSON `detail`-meddelande och valfria headers.

## Returnera ett anpassat Response direkt

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

## Varför det är viktigt

Rätta statuskoder och headers är väsentliga för att bygga korrekta, väluppförda REST-API:er — klienter och verktyg förlitar sig på standard HTTP-semantik (201 för skapad, 404 för hittades inte, 204 för inget innehål, osv.), så att returnera rätt kod är del av ett kvalitets-API-kontrakt.

FastAPI ger dig ren kontroll: en standard `status_code` på rutten för det vanliga fallet, det injicerbara `Response`-objektet för dynamiska koder/headers, och `HTTPException` som det idiomatiska sättet att signalera fel med lämplig status och JSON-detaljer.

Att förstå dessa mekanismer — och använda `status`-konstanter för klarhet — är vardagskunskap för att bygga API:er som beter sig korrekt och kommunicerar tydligt med sina konsumenter.