State API

Les informations d'une instance Event Engine sont obtenues avec 2 requêtes.

Une requête côté serveur vers l'administration Event Engine retourne l'url du service d'état du lecteur.
L'url du service d'état du lecteur retourne les informations concernant le lecteur.

La requête côté serveur est limitée à un appel maximum par seconde, un quota limite aussi le nombre d'appel par minutes.
Elle est porteuse d'un token (bearer) au format JWT HS256, token signé avec un secret (clef d'API) et ne contient que l'ID de audience associée à la clef et la date d'expiration du token (TTL conseillée de 30 à 60s).

L'url du service d'état change avec l'horloge du serveur Event Engine toutes les 30 minutes et reste valable 1 heure.
Elle répond avec un cache de 5s. Il est conseillé de la mettre à jour toutes les 15 minutes environ. Côté serveur, la valeur de l'url du service peut donc être mise en cache pour 15 minutes.

Limitations