FastAPI 0.157 est sorti
par Makersquad ·
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.