🔎 Principe
Avensys met à disposition des API REST permettant d’interagir avec vos applications ou logiciels métiers.
Ces API permettent notamment d’automatiser certains échanges de données ou d’intégrer Avensys dans votre système d’information.
Une documentation technique dédiée aux développeurs est disponible en ligne.
⚙️ Documentation développeur
La documentation complète des API est accessible à l’adresse suivante :
https://documentation.avensys.io/devs/
Cette documentation présente :
les différents endpoints disponibles
les paramètres attendus
les formats de réponse
les exemples d’utilisation
Les notes de mises à jour (changelog) sont également disponibles pour suivre les évolutions de l’API :
https://documentation.avensys.io/devs/api-rest/changelog/v1/
⚙️ Accès au Swagger
Un Swagger est également disponible sur votre instance Avensys afin de tester directement les API.
Adresse d’accès :
https://[nom_client].a26.fr/dossier/help/restapi/index
Cette interface permet de :
consulter les endpoints disponibles
tester les appels API
visualiser les paramètres et réponses possibles
En haut de l’interface, il est possible de sélectionner la version de l’API utilisée (V1 ou V2).
🚀 Version des API
Deux versions d’API peuvent être disponibles :
La migration entre les versions s’effectue progressivement selon les besoins internes ou les évolutions fonctionnelles.
Les projets existants peuvent continuer à utiliser la version actuelle tant que la migration n’est pas nécessaire.