Historique des versions

#Gestion des versions

La version figure dans l’adresse : /api/v1. Un flux ou une intégration construit sur la v1 n’a pas à être refait quand AttendBeacon évolue ; au sein de la v1 :

• Ajouté, jamais retiré. De nouvelles opérations, de nouveaux champs dans les réponses, de nouveaux paramètres facultatifs, de nouvelles valeurs dans une liste comme un type de webhook ou un code d’erreur. Écrivez du code qui ignore ce qu’il ne connaît pas.
• Jamais renommé ni supprimé, une fois publié : un champ, une opération, une autorisation, un code d’erreur ou un type de webhook.
• Un changement incompatible, c’est la v2. Il est annoncé ici et par e-mail à chaque espace de travail disposant d’une clé, au moins six mois avant que la v1 ne change, et la v1 continue de fonctionner pendant ces six mois.
• Ce qui est déprécié est marqué deprecated dans la description OpenAPI et listé ici, avec sa date de retrait.

Ne sont pas des changements en ce sens : l’ordre des champs dans un corps, le texte de detail (basez-vous sur code), les nouveaux en-têtes de réponse, et la correction d’une réponse qui contredisait cette documentation.

La description OpenAPI 3.1 à l’adresse /api/v1/openapi.json décrit l’API telle qu’elle est aujourd’hui ; info.version change à chaque ajout.

#15 octobre 2026 : v1.1, la plateforme développeurs

• Autorisations par domaine. Les autorisations d’une clé associent désormais un domaine et un accès (events:read, attendees:write), et les données personnelles ont leur propre autorisation, people:read. Les clés créées auparavant conservent exactement ce qu’elles pouvaient faire.
• Les clés expirent et sont journalisées. Une clé peut expirer après 30, 90, 180 ou 365 jours. Chaque appel figure dans Activité des clés, refus compris.
• Problem details. Les refus sont au format RFC 9457 application/problem+json, avec un code stable ; error reste à côté de detail pour les flux créés auparavant.
• Curseurs et synchronisation. Chaque liste renvoie nextCursor et hasMore ; les listes d’éléments qui changent acceptent updatedSince. page et pageSize fonctionnent toujours là où ils fonctionnaient.
• Nouvelles tentatives et modifications sans risque. Idempotency-Key sur chaque POST ; ETag sur les ressources individuelles, If-None-Match et If-Match.
• En-têtes de limite de débit. RateLimit, RateLimit-Policy et X-RateLimit-* sur chaque réponse, Retry-After avec un 429.
• Nouvelles opérations : l’espace de travail ; la création d’événements en brouillon, la modification de leurs informations de base et leur publication ; les statistiques d’un événement et le rythme des ventes ; les types de billets (et leur modification), les options et les codes de réduction (et leur création) ; une commande ; la recherche de participants ; les comptages aux entrées ; les sessions (et leur ajout et modification), les salles, les parcours et les intervenants ; les sponsors et les niveaux de sponsoring ; les propositions de l’appel à propositions ; l’équipe et les créneaux ; les enquêtes, leurs résultats et les évaluations des sessions ; les factures et les avoirs ; la synthèse du budget ; le classement du kit de partage ; les communautés et leurs membres ; les points de terminaison webhook, leurs livraisons, tests et secrets, ainsi que les types d’événements avec les schémas de leur contenu.
• Modules. Un module désactivé pour un événement répond 409 moduleOff sur ses points de terminaison. Cela s’applique aussi aux entrées, aux scans aux entrées et à l’enregistrement des arrivées (le module de contrôle d’entrée) ainsi qu’aux prospects (le module des prospects), qui répondaient auparavant.
• Personnes. Sans people:read, les participants, acheteurs, membres de l’équipe et membres des communautés ne sont que des identifiants ; les prospects et la recherche de participants l’exigent. Une personne qui a supprimé ses données est erased, sans rien de personnel.
• Descriptions. /api/v1/openapi.json est désormais en OpenAPI 3.1, avec des exemples et tous les refus ; la description Swagger 2.0 qu’importe Power Platform se trouve à /api/v1/swagger.json.
• Le serveur MCP à l’adresse /mcp, pour les assistants IA.

#12 octobre 2026 : v1.0

• Les événements, les participants avec leurs réponses, les commandes et les scans aux entrées d’un espace de travail, avec updatedSince.
• L’inscription de quelqu’un avec un billet gratuit, l’annulation d’un billet et l’enregistrement d’une arrivée.
• Les abonnements pour Power Automate, Zapier et Make (/hooks), et des webhooks signés selon Standard Webhooks.
• Les questions d’inscription, leur schéma JSON, les types de billets, les entrées et les prospects récents, pour les sélecteurs et les champs des flux.