Aller au contenu

SSE (Server-Sent Events)

Les Server-Sent Events sont un flux HTTP unidirectionnel : le serveur pousse, le client écoute. Restorm en fait un type de requête à part entière.

Clic droit dans l’arbre ▸ Ajouter ▸ Requête SSE.

Un onglet SSE connecté : à droite, chaque événement reçu apparaît avec son horodatage, son nom («ping») et sa charge utile (un numéro de séquence).

ChampRôle
URLLe point d’entrée du flux
En-têtesLes en-têtes de la requête d’ouverture — c’est là que passe l’authentification
Dernier identifiant d’événementValeur d’amorçage de l’en-tête Last-Event-ID, envoyée à la première connexion seulement

Restorm suit la spécification EventSource : il analyse les champs event:, data:, id: et retry:, et affiche chaque événement reçu avec son horodatage, son nom et sa charge utile — un clic sur un événement en déplie le contenu complet. L’identifiant, lui, est retenu pour la reconnexion.

En cas de coupure, la reconnexion réémet automatiquement le dernier identifiant reçu dans Last-Event-ID — c’est ce qui permet au serveur de reprendre là où il en était.

Le flux est en réception uniquement : il n’y a rien à envoyer une fois la connexion ouverte.

Deux actions : Connexion SSE (sorties connected et message, une émission par événement reçu) et Fermeture connexion SSE. Voir Connexions et flux.

Le motif habituel : ouvrir le flux, déclencher l’action métier par un appel HTTP, puis vérifier avec une assertion que l’événement attendu arrive bien sur le port message.

Trois cibles : cURL, EventSource du navigateur, Python (requests en flux).