Mihin `response_model` parametri on tarkoitettu?

Question

Accepted Answer

**`response_model`** parametri määrittää päätepisteen vastauksen rakenteen. FastAPI käyttää sitä **validoidakseen, suodattaakseen ja serialisoidakseen** palautettavaa dataa — ja dokumentoidakseen vastauksen API-dokumentaatioon. Sen tärkein tehtävä: varmistaa, että eksponoit vain tarkoituksenmukaiset kentät (esim. et koskaan vuoda salasanaa).

## Ongelma: herkkien kenttien vuotaminen

```python
class User(BaseModel):
    name: str
    email: str
    password: str        # ⚠️ should NEVER be in the response!

@app.get("/users/{id}")
def get_user(id: int) -> User:
    return db.get_user(id)   # returning the full object would expose the password
```

## Ratkaisu: erillinen vastaustekijä

```python
class UserOut(BaseModel):    # the SAFE public shape — no password
    name: str
    email: str

@app.get("/users/{id}", response_model=UserOut)
def get_user(id: int):
    return db.get_user(id)   # returns a full user, but FastAPI FILTERS it to UserOut
# response → { "name": "...", "email": "..." }  — password stripped automatically
```

Kayttamällä `response_model=UserOut`, FastAPI ottaa kaiken, mitä palautat, ja **suodattaa sen** vain `UserOut`-muodossa ilmoitettuihin kenttiin — joten salasana (ja muut ylimääräiset kentät) poistetaan vastauksesta, vaikka palautit täydellisen objektin.

## Mitä response_model tekee

```text
✓ FILTERS the output to only the declared fields (key for hiding sensitive data)
✓ VALIDATES that your response matches the declared schema (catches mistakes)
✓ SERIALIZES the data to JSON correctly
✓ DOCUMENTS the response shape in the OpenAPI/Swagger docs
```

## Moderni vaihtoehto: palautustyypin annotaatio

```python
@app.get("/users/{id}")
def get_user(id: int) -> UserOut:    # the -> return type works like response_model
    return db.get_user(id)
# response_model_exclude_unset=True → omit fields not explicitly set
```

## Miksi se on tärkeää

`response_model` on tärkeä sekä **turvallisuuden** että puhtaan API-suunnittelun kannalta.

Sen kriittisin rooli on tahattomien tietojen vuotojen estäminen — määrittelemällä tarkasti, mitkä kentät vastauksen tulisi sisältää, FastAPI suodattaa kaikki muu pois (kuten salasanahajautukset, sisäiset liput tai tunnukset) vaikka koodisi palauttaisi täydellisen tietokantaobjektin, eliminoiden yleisen ja vakavan haavoittuvuuden.

Sen lisäksi se validoi vastauksesi ilmoitettua skeemaa vastaan (päättelee virheet, joissa palautat väärän rakenteen), varmistaa oikean sarjallistamisen ja dokumentoi vastauksen automaattisesti generoidussa API-dokumentaatiossa.

Erillisten syötön ja tuloksen mallien käyttämisen kuvio (`response_model`-ohjaimella hallita, mitä eksponoidaan) on parhaiden käytäntöjen mukainen turvallisille, hyvin määritellyille API:ille, mikä tekee tästä tärkeää tietoa kaikille päätepistille, jotka palauttavat dataa.