Motimate : Comment passer de l'API publique v1 à v2 ?

Notre nouvelle API publique v2 (PAPI v2) est maintenant lancée, offrant un service plus flexible et plus utile ✨

Quelles seront les nouveautés ?

Avec PAPI v2, vous avez accès à un plus grand nombre de données sur un plus grand nombre de points d'extrémité. Plus précisément, vous pourrez désormais exporter davantage de données et mieux contrôler votre espace MotiSpace via l'API.

Que devez-vous faire ?

Rien pour l'instant. Pour l'instant, nous avons simplement lancé la nouvelle version et permis à ceux qui le souhaitent de commencer à l'utiliser. Aucun changement ne sera imposé à qui que ce soit pour le moment. Veuillez lire la suite pour en savoir plus sur le calendrier prévu et sur la date à laquelle nous attendons que tout le monde prenne des mesures pour mettre à niveau le système (ce calendrier n'est encore que provisoire).

Comment puis-je tester la v2 sans procéder à une mise à jour complète ?

Afin de commencer à utiliser l'interface PAPI v2 tout en restant techniquement intégré à la v1, l'en-tête HTTP motimate-public-api-version doit être défini comme suit : v2.

Lorsque vous serez prêt à passer définitivement à la version 2, informez-en le service d'assistance, qui configurera le back-end de manière à ce que cet en-tête devienne obsolète.

Si vous avez testé la v2 alors qu'elle était en version bêta, vous n'avez pas besoin d'apporter de modifications, puisque la v2 n'a pas changé par rapport à la version bêta.

Le passage à la version 2 nécessitera-t-il des changements importants dans la mise en œuvre de la version 1 ?

Le passage à l'interface PAPI v2 ne devrait pas nécessiter de changements majeurs, car il s'agit principalement d'ajustements mineurs concernant l'utilisation de nos points de terminaison Utilisateurs, Groupes et Positions. Ceci étant dit, les clients utilisant des développeurs tiers sur des consultants, auront naturellement besoin d'un peu de temps pour mettre à jour et tester leurs intégrations.

Qu'est-ce qui change en ce qui concerne l'authentification ?

Rien, tant que vous utilisez déjà la PAPI v1, vous utiliserez toujours les mêmes informations d'identification que vous avez reçues de l'équipe Motimate lors de votre première demande d'accès à l'API afin d'obtenir vos jetons d'authentification de 24 heures.

La version 1 sera-t-elle obsolète ? Quel est le calendrier ?

Dans un premier temps, nous avons simplement lancé PAPI v2 et permis aux utilisateurs de le mettre à jour et de commencer à l'utiliser. 

À un moment donné, nous ferons une annonce pour informer que nous allons supprimer la version 1 et, à partir de ce moment, nous accorderons une période de transition de 6 mois à tous les utilisateurs pour qu'ils passent à la version 2. Notez qu'il s'agit d'un plan provisoire, susceptible d'être modifié.