Points d'accès
Toutes les opérations vivent sous https://kult-lab.com/api/v1/channel. La connexion est celle de la
clé : aucune adresse ne porte d'identifiant à configurer. Chaque appel est
signé.
| Méthode | Chemin | Rôle | Budget |
|---|---|---|---|
POST | /hello | déclarer l'application | 10 par 15 min |
GET | / | où en est la connexion : parties, vérifications en échec, capacités en vigueur, décalage d'horloge | 60 par min |
POST | /events | envoyer des événements | 300 par min |
POST | /verify | lancer les vérifications d'une partie | 6 par heure |
GET | /commands | relever les commandes, seulement sans commandsUrl | 60 par min |
POST | /commands/{commandId}/result | une réponse différée à une commande | 60 par min |
Dans l'autre sens, Kult Lab appelle une seule adresse : POST {commandsUrl}
(Commandes).
Un budget dépassé répond 429 avec Retry-After. Un appel refusé (clé ou signature) ne consomme
pas de budget : une clé volée sans son secret ne peut pas épuiser celui de votre application.
Un envoi à la fois
Kult Lab traite un lot à la fois par connexion et le fait respecter : un second POST /events
arrivé pendant le premier reçoit un 409. Réessayez une seconde plus tard. Dans un lot, les
événements sont lus dans l'ordre du tableau.
C'est ce qui protège une bascule bleu/vert, où deux processus vident la même file d'envoi un court instant. Il n'y a pas de numéro de séquence à tenir.
Le schéma
Le schéma OpenAPI de chaque opération, avec ses champs et ses types, est servi par l'application à
/api/v1/docs. Ce guide en donne le sens ; le schéma fait foi
sur la forme.