FastAPI 0.135 est sorti
par Makersquad ·
Date de sortie : 1er mars 2026
Release officielle : FastAPI 0.135.0
Moins de deux jours après la 0.134 et son streaming JSONL, FastAPI ajoute le support des Server-Sent Events (SSE).
La nouveauté
Server-Sent Events
Exposer un flux SSE devient trivial. On déclare la réponse avec response_class=EventSourceResponse et on émet chaque message avec yield :
from collections.abc import AsyncIterable
from fastapi import FastAPI
from fastapi.sse import EventSourceResponse, ServerSentEvent
app = FastAPI()
@app.get("/notifications", response_class=EventSourceResponse)
async def notifications() -> AsyncIterable[ServerSentEvent]:
async for event in listen_for_events():
yield ServerSentEvent(
event="notification",
data={"message": event.text},
id=str(event.id),
)
Le champ data est toujours encodé en JSON. Pour envoyer du texte sans encodage JSON, par exemple des lignes de log ou une valeur sentinelle comme [DONE], la documentation propose raw_data à la place de data (les deux s’excluent).
Côté client, la consommation reste standard avec l’API EventSource du navigateur. Comme data est encodé en JSON, le client le décode avec JSON.parse :
const source = new EventSource("/notifications");
source.addEventListener("notification", (e) => {
const payload = JSON.parse(e.data);
console.log(payload.message);
});
Ce que FastAPI prend en charge
SSE est un standard pour envoyer des données du serveur vers le client en HTTP, que les navigateurs supportent nativement avec EventSource. La documentation officielle en cite les usages courants : chat IA en streaming, notifications en direct, logs et observabilité, et plus généralement les cas où le serveur pousse des mises à jour vers le client.
FastAPI applique de lui-même quelques bonnes pratiques :
- un commentaire
pingde maintien de connexion toutes les 15 secondes sans message, pour éviter que certains proxies ferment la connexion ; - l’en-tête
Cache-Control: no-cache, pour empêcher la mise en cache du flux ; - l’en-tête
X-Accel-Buffering: no, pour empêcher la mise en tampon dans certains proxies comme Nginx.
Quand un navigateur se reconnecte après une coupure, il envoie le dernier id reçu dans l’en-tête Last-Event-ID. Votre endpoint peut le lire comme un paramètre d’en-tête pour reprendre le flux là où le client s’était arrêté. SSE fonctionne aussi avec une autre méthode que GET, par exemple POST.
Nouvelle documentation
Server-Sent Events (SSE) (s’ouvre dans un nouvel onglet) rejoint le catalogue de tutoriels.
À retenir
Si vous avez besoin d’un flux unidirectionnel serveur vers client, FastAPI sait désormais l’exposer avec EventSourceResponse et yield, dans la lignée du streaming JSONL de la 0.134.