L'API 3.0 est la version par défaut de l'API et nous vous recommandons d'utiliser cette version lors de la création de nouvelles intégrations. Nous continuerons à prendre en charge les API 2.0 et 2.1 dans un avenir prévisible et nous fournirons un préavis d'au moins 12 mois avant de désactiver ces versions.
Nous avons beaucoup appris lors de la transition de l'API 1.2 à l'API 2. Cette fois, nous avons rendu la mise à niveau beaucoup plus facile à gérer. L'API 3.0 ajoute de nouvelles fonctionnalités tout en ne modifiant les fonctionnalités existantes que lorsque cela est absolument nécessaire. Cela signifie que les intégrateurs devraient être en mesure de passer à la nouvelle API avec un minimum de tracas. Cela signifie également que, même si nous vous recommandons de commencer à planifier votre mise à niveau dès que possible afin que votre organisation et vos chercheurs puissent bénéficier des nouvelles fonctionnalités, vous disposez d'une grande flexibilité pour décider quand effectuer la mise à jour vers la 3.0.
La petite liste des changements potentiellement décisifs se trouve dans nos notes de version de l'API ici et ici. Il y a quelques changements concernant les champs facultatifs/obligatoires, les énumérations JSON ont été légèrement modifiées, et nous avons également une petite refactorisation de nos schémas XML, ajoutant de nouveaux champs pour contenir les métadonnées requises pour la nouvelle fonctionnalité.