Automatiser votre show avec l'API REST Timers Studio
Un guide pratique de l'API REST a 53 endpoints. Authentification, controle de minuteries, streaming SSE et patterns d'automatisation reels.
· Technique · 10 min read
J'ai automatise mon premier show en 2019 avec un script Python qui envoyait des messages OSC a une application de minuterie proprietaire tournant sur un portable Windows cache sous une console de mixage. Le script a fonctionne exactement une fois, pendant la repetition, puis a echoue de facon spectaculaire pendant le show live parce que le portable s'etait mis en veille et le socket OSC s'etait ferme.
L'API REST Timers Studio est basee sur HTTP, ce qui resout immediatement les modes de defaillance d'automatisation les plus courants. HTTP ne se soucie pas des sockets persistants. Si votre serveur d'automatisation redemarre, la requete suivante fonctionne toujours.
L'authentification utilise des tokens Bearer. Vous generez une cle API dans votre tableau de bord Timers Studio, et chaque requete l'inclut dans l'en-tete Authorization. Le token est scope a votre compte. Il n'y a pas de danse OAuth, pas de tokens de rafraichissement, pas d'expiration a gerer.
Le pattern d'automatisation le plus courant est le controle de minuterie. L'API expose des endpoints pour chaque action de minuterie: demarrer, mettre en pause, reprendre, arreter, reinitialiser, et cue suivant. Une automatisation typique pourrait ressembler a ceci: votre systeme de playout video finit un VT, il envoie un webhook a votre serveur d'automatisation, votre serveur appelle l'API Timers Studio pour avancer au cue suivant. Le nouveau compte a rebours apparait sur chaque ecran de la salle en moins de 200 millisecondes.
La dimension temps reel vient des Server-Sent Events. Tandis que les endpoints REST vous permettent d'envoyer des commandes a Timers Studio, le SSE permet a Timers Studio de pousser les changements d'etat vers vous. Vous ouvrez une seule connexion HTTP vers l'endpoint SSE, et Timers Studio streame chaque changement d'etat au fur et a mesure.
Un pattern que j'utilise frequemment est ce que j'appelle la "machine d'etat du show." Au lieu de scripter des appels API individuels pour chaque transition, je definis une machine d'etat ou chaque etat represente un segment du show et chaque transition represente un evenement.
Pour les equipes qui preferent l'automatisation no-code, l'API Timers Studio fonctionne parfaitement avec n8n, Make et Zapier. La gestion des erreurs est simple. Chaque endpoint retourne des codes de statut HTTP standard.
La reference API complete documente les 53 endpoints avec les parametres de requete, les schemas de reponse et des exemples curl. Si vous pouvez ecrire une commande curl, vous pouvez automatiser votre show.