Versions

Le protocole suit une règle : strict à l'entrée, souple à la sortie.

• Kult Lab refuse un champ inconnu dans ce que vous envoyez.
• Votre application ignore un champ inconnu dans une commande, et répond not_supported à un type de commande qu'elle ne connaît pas.

Ce qui arrive sans nouvelle version

Un ajout : un champ facultatif, un type d'événement, un type de commande, une capacité. Votre application continue de fonctionner sans rien changer, et adopte l'ajout quand elle le veut.

Ce qui ouvre une nouvelle version

Un changement qui casserait une application existante (un champ retiré, renommé, un sens changé) se publie sous /api/v2. /api/v1 reste servi au moins douze mois après.

Le bonjour annonce la version que vous parlez (protocol), et sa réponse celles que Kult Lab accepte (protocol.min, protocol.max).