Fin de la prise en charge de l’ancienne API REST : action requise
Ceci est un rappel au sujet des changements importants relatifs aux aspects techniques de la création d’intégrations externes avec YouTrack qui sont intervenus et des actions à effectuer d’ici fin juin 2021 par les administrateurs de YouTrack et les personnes chargées de mettre en place les intégrations externes pour vos équipes.
Qu’est-ce qui change ?
Il y a deux ans, nous avons annoncé que nous allions commencer à publier progressivement des ressources et méthodes pour une nouvelle API REST. Nous avons fait de notre mieux pour rendre la nouvelle API soit suffisamment sûre et souple afin de permettre à nos utilisateurs de créer efficacement des intégrations personnalisées, tout en conservant les solutions aux difficultés que nous avions apportées à l’ancienne API.
La nouvelle API REST est une fonctionnalité de qualité qui est maintenant entièrement prise en charge, nous allons donc désormais concentrer nos efforts sur sa maintenance et son amélioration.
Nous prévoyons de commencer la transition en juillet 2021 et de la terminer d’ici la fin de l’année. Bien entendu, nous nous assurerons de la migrations de tous nos bibliothèques, plugins et widgets officiels vers la nouvelle API avant de désactiver l’ancienne.
Quelles sont les méthodes de l’ancienne API REST ?
Les méthodes de l’API REST de YouTrack sont principalement utilisées pour créer des intégrations personnalisées entre YouTrack et des outils tiers, en étendant les fonctionnalités natives de YouTrack. Une intégration pourrait par exemple permettre de récupérer des tickets de YouTrack et ensuite créer un graphique personnalisé à partir de ces données. Si votre équipe a créé des intégrations personnalisées, veuillez prendre un moment pour les passer en revue. Les anciennes méthodes sont celles qui utilisent le préfixe URL /rest, tandis que les nouvelles méthodes utilisent /api.
Action requise de la part des utilisateurs
Une fois la transition terminée, il ne sera plus possible d’utiliser l’ancienne API REST sur les versions de YouTrack publiées en juillet 2021 ou plus tard. Toutes les intégrations personnalisées qui s’appuient sur les méthodes de l’ancienne API REST cesseront également de fonctionner. Veillez à migrer tout votre code personnalisé vers la nouvelle API REST avant juillet 2021 pour éviter toute interruption dans votre travail quotidien. Après le 1er juillet 2021, nous ne seront plus en mesure de garantir le fonctionnement des méthodes de l’ancienne API REST.
La documentation de la nouvelle API REST fournit des descriptions détaillées des nouveaux points de terminaison et nous proposons également un ensemble d’exemples prêts à l’emploi pour vous aider à vous familiariser avec la nouvelle API.
Qu’en est-il des intégrations de YouTrack avec des outils externes ?
Nous savons que certaines intégrations de YouTrack ne peuvent pas être modifiées par nos utilisateurs, notamment les intégrations avec les systèmes de gestion des tests. Nous prévoyons de contacter les représentant·es de ces applications pour leur communiquer les changements à venir et leur apporter notre aide possible afin d’assurer la migration de ces intégrations vers la nouvelle API REST
Si vous avez des questions ou besoin d’aide pour migrer vos intégrations vers la nouvelle API REST, contactez notre équipe d’assistance. Nous sommes toujours ravis de vous aider !
L’Équipe YouTrack
Auteur de l’article original en anglais : Anastasia Bartasheva
Subscribe to YouTrack Blog updates
