Versions

L'API porte deux repères :

• /v1 dans l'adresse : la génération de l'API. Elle ne change pas.
• Une version datée, aujourd'hui 2026-10-01, dans l'en-tête Lidmeo-Version. Chaque réponse dit la version qui a répondu.

Votre version est figéeCopier le lien

Une clé d'API retient la version du jour de sa création, une adresse de réception de webhooks aussi : votre intégration continue de recevoir exactement ce qu'elle attend, même quand une nouvelle version sort. Pour en essayer une autre, envoyez l'en-tête sur une requête :

Lidmeo-Version: 2026-10-01

Une version inconnue répond 400 invalid_api_version. Une connexion OAuth sans en-tête reçoit la dernière version.

Ce qui change sans nouvelle versionCopier le lien

Les ajouts arrivent sans prévenir, dans toutes les versions :

• de nouvelles opérations, de nouveaux paramètres facultatifs ;
• de nouveaux champs dans les réponses et les événements ;
• de nouveaux types d'événements ;
• de nouvelles valeurs dans une liste de valeurs possibles (une nouvelle étape, un nouveau code d'erreur).

Écrivez votre code pour les tolérer : ignorez un champ que vous ne connaissez pas, prévoyez un cas par défaut pour une valeur inconnue, et abonnez vos webhooks à des types précis plutôt qu'à * si votre code ne sait traiter que ceux-là.

Ce qui demande une nouvelle versionCopier le lien

Retirer ou renommer un champ, changer son type ou son sens, rendre un paramètre obligatoire : cela n'arrive que dans une nouvelle version datée, au plus deux fois par an, annoncée dans le journal des changements. Une version reste servie au moins 18 mois ; quand sa fin approche, ses réponses portent les en-têtes Deprecation et Sunset.