Aller au contenu

Galaxie Artibox

Historique des versions de l'API

Ce qui a changé dans l'API publique, lot après lot. Les ajouts restent compatibles avec les intégrations existantes.

Cet historique des versions de l'API liste les changements visibles par les développeurs. Les nouveautés du produit pour tous les utilisateurs sont sur la page nouveautés. La description à jour de chaque route est toujours dans la référence de l'API et le document openapi.json, générés à partir du code.

Comment lire l'historique des versions de l'API

Les lots sont classés du plus récent au plus ancien. Chacun ajoute des routes ou des champs ; les intégrations écrites pour un lot précédent continuent de fonctionner.

M5 : nouvelles routes, MCP et documentation publique

Publié le 17 novembre 2026.

Ajouté

  • Trois portées : disponibilites:ecrire (plannings et exceptions de son propre compte), journal:lire (journal d'audit) et donnees:effacer (export et effacement des données d'un invité).
  • Disponibilités : écriture des plannings et des exceptions, PUT /exceptions/{id}, et GET /busy-times, les heures occupées d'un membre sur 31 jours au plus, sans jamais le titre d'un événement.
  • Réunions ponctuelles : POST, GET et DELETE /one-off-meetings, un rendez-vous à créneaux choisis proposé une fois par un lien à usage unique.
  • Compte et organisation : GET /users/me (aussi point « userinfo » d'OAuth), GET /members/{id}, les invitations (GET, POST, DELETE /invitations) et GET /audit.
  • Données personnelles : GET /privacy/guest, POST /privacy/guest/erase et POST /privacy/bookings/erase pour une période.
  • Orientation : GET /orientation-forms/{id}/submissions et GET /orientation-submissions/{id}.
  • Rendez-vous de groupe : GET /bookings/{id}/session, la séance et ses inscrits.
  • Webhooks : GET /webhook-subscriptions/{id}, un test qui peut imiter un événement réel ({"event": …}), et le rejeu d'une livraison ouvert aux jetons.
  • OAuth : introspection (RFC 7662) et métadonnées du serveur (RFC 8414, /.well-known/oauth-authorization-server).
  • Le serveur MCP pour les assistants IA, sur /api/v1/mcp.
  • La documentation publique : ce portail, la référence générée et la description OpenAPI 3.1.

Modifié

  • Pagination facultative sur plusieurs listes (types, sondages, membres, liens uniques, formulaires d'orientation, invitations, réunions ponctuelles, abonnements) : sans page ni limit, la réponse reste la liste entière, comme avant.
  • POST /notifications/read ouvert à la portée utilisateur:lire.

L8c : connecteurs CRM

  • Connecteurs HubSpot, Salesforce et Pipedrive, réglés dans l'application (intégrations CRM).
  • GET /bookings/{id}/crm : les synchronisations CRM d'un rendez-vous.
  • Filtres context_source et context_id sur GET /bookings, pour retrouver les rendez-vous d'un objet de votre outil.

L8b : OAuth 2 et sans code

  • Applications OAuth déclarées par le propriétaire, écran de consentement, code d'autorisation de 10 minutes à usage unique avec PKCE S256, jeton d'accès de 2 heures, jeton de rafraîchissement renouvelé à chaque usage. Voir authentification.
  • « Applications connectées » pour retirer un accès ; une application gère ses propres webhooks et n'entend que ce que voit son membre.
  • Recherche des rendez-vous par courriel et création de liens signés par l'API.
  • Applications Zapier et Make (publication dans les catalogues en cours) : voir Zapier et Make.

L8 : l'API publique et les webhooks

  • Les routes /api/v1 ouvertes aux jetons personnels (x-api-key: rdv_pat_…), avec leurs portées.
  • 100 appels par minute et par jeton, Idempotency-Key sur les créations, origine api sur les rendez-vous créés.
  • Webhooks signés (X-Signature), réessayés d'une minute à douze heures, désactivés après 20 échecs, journal de 30 jours, test et rejeu : voir webhooks.
  • Paramètres de suivi utm_*, gclid, fbclid et ref sur les rendez-vous, et le widget d'intégration.

Suivez l'API

Toute la description est dans la référence, générée à chaque version.

Voir la référence