Aller au contenu
Makersquad

FastAPI 0.157 est sorti

par Makersquad ·

Logo de FastAPI sur fond dégradé

Date de sortie : 21 octobre 2026

Documentation officielle : FastAPI 0.157.0

FastAPI 0.157.0 est sorti le 21 octobre 2026. Une nouveauté, plus deux clarifications de documentation.

Les nouveautés principales

Combiner des modèles de paramètres

On peut combiner plusieurs modèles de paramètres de requête (query), d’en-tête (header) et de cookie, ainsi qu’avec des paramètres individuels et des dépendances (voir la documentation (s’ouvre dans un nouvel onglet)) :

class Pagination(BaseModel):
    limit: int = Field(10, ge=1)
    offset: int = Field(0, ge=0)


class Filters(BaseModel):
    tags: list[str] = []


@app.get("/items/")
def read_items(
    pagination: Annotated[Pagination, Query()],
    filters: Annotated[Filters, Query()],
    search: str | None = None,
):
    return {"pagination": pagination, "filters": filters, "search": search}

Les paramètres restent au même niveau dans la requête : /items/?limit=5&offset=10&tags=red&tags=blue&search=shirt, sans clé pagination ni filters. Chaque modèle valide ses champs indépendamment, avec ses propres valeurs par défaut et validateurs. Les points à connaître :

  • un nom partagé entre deux modèles est validé par chacun ; OpenAPI ne le liste qu’une fois, les déclarations partagées doivent donc décrire le même type et les mêmes contraintes ;
  • avec extra="forbid", un paramètre déclaré ailleurs dans l’opération (autre modèle, paramètre individuel, dépendance) est accepté ; la 0.160 change cette règle (voir ci-dessous) ;
  • chaque modèle d’en-têtes garde son propre réglage convert_underscores.

Changements incompatibles

Les notes n’annoncent aucun changement incompatible. La règle extra décrite plus haut change toutefois en 0.160, qui est un changement incompatible : voir FastAPI 0.160 est sorti.

À retenir

FastAPI 0.157 ne contient aucun changement incompatible. Les clarifications de documentation portent sur l’analyse des paramètres de requête booléens, les paramètres de requête nullables et les valeurs par défaut des paramètres de chemin.

Échanger avec un expert FastAPI

De l’idée au marché. Makersquad conçoit des logiciels sur mesure, pensés pour durer, avec de petites équipes d’experts autonomes. Depuis 2018.