L’outil
OpenAPI, c’est quoi ?
OpenAPI est un format standard pour décrire une API, c’est-à-dire les services qu’un logiciel rend à d’autres programmes. Le fichier écrit dans ce format sert de mode d’emploi : il liste ce que l’on peut demander au logiciel, les informations à fournir et les réponses à attendre. Il se lit aussi bien par les personnes que par les programmes. Beaucoup d’éditeurs en publient un pour leur API et il sert à produire des pages de documentation. Le format s’appelait autrefois Swagger, un nom que l’on croise encore souvent. Il est aujourd’hui géré par l’OpenAPI Initiative, rattachée à la Linux Foundation.
Cas d’usage
Ce que vous pourrez faire
- Relier l’outil à un logiciel métier dont l’éditeur publie une description OpenAPI de son API.
- Donner à votre agent IA le mode d’emploi exact d’une API, pour limiter les erreurs dans l’outil.
- Connecter un outil à une API interne que votre équipe informatique a décrite au format OpenAPI.
- Afficher dans l’outil des données venues d’un autre logiciel, comme des contrats ou des fiches fournisseurs, sans ressaisie.
Mise en place
Comment ça marchera
Cette intégration est en préparation. Lorsqu’elle arrivera, vous pourrez confier à votre agent la description OpenAPI du logiciel à relier, avec votre besoin : « Voici la description OpenAPI de notre logiciel de gestion des contrats. Crée un outil qui liste les contrats à renouveler ce trimestre et permet d’attribuer chaque dossier. » L’agent s’appuiera sur ce mode d’emploi pour écrire l’outil sans deviner, puis Genipy le vérifiera et le mettra en ligne. Si vos logiciels publient une description OpenAPI, indiquez-le pendant la démo : cela compte dans l’ordre de nos travaux.
En préparation. Les outils publiés sur Genipy ne se connectent pas encore à OpenAPI. Dites-nous en démo que vous en avez besoin : les intégrations les plus demandées passent en premier.
GraphQLAPI et automatisation
n8nAPI et automatisation