TimePerformance API version 4
Il s’agit d’une nouvelle version de l’API car des modifications ne sont pas rétrocompatibles. La version 3 de l’API sera maintenue jusqu’au 31 décembre 2023.
Cette mise à jour de l’API contient:
- Des nouvelles API
- Nouvelle documentation au format OpenAPI
- Modification de certaines API existantes dans le but de simplifier ou d’uniformiser (cf. guide de migration ci-dessous)
Nouvelle documentation au format OpenAPI
Une nouvelle documentation a été mise en ligne qui est générée depuis un fichier de spécification au format OpenAPI v3.0. Cette nouvelle version permet de tester l’API directement depuis la documentation.
Il est aussi possible de récupérer le fichier de spécification de l’API au format OpenAPI afin de l’utiliser dans un environnement de développement. Il existe des plugins pour les IDE (ex: « OpenAPI (Swagger) Editor » pour VS Code) ou des outils de génération de code.
Nouvelles API
Une dizaine d’API ont été ajoutées principalement pour importer ou modifier des données.
Pour l’instant, les API de modification concernent les projets, les fiches projet, les utilisateurs et les équipes projets. Dans les futures versions, il sera aussi possible de modifier les tâches, les livrables, les phases…
Les API de modification des données nécessitent un accès Back Office disponible uniquement en version Premium, contrairement aux API qui extraient des données disponibles dès la version Standard. La version Premium est en cours de développement. Les fonctionnalités Premium sont actuellement offertes aux Clients ayant choisi l’option SSO.
Guide de migration de la v3 à la v4
Continuer la lecture de « TimePerformance 12 mars 2023 »