Bientôt disponibleAPI et automatisation

Toolify et OpenAPI

Bientôt, vos outils internes Toolify pourront se connecter aux logiciels dont l’API est décrite au format OpenAPI, le mode d’emploi standard des API.

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.

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.

Comment ça marchera

Ce connecteur est en préparation. Lorsqu’il 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 Toolify 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 Toolify ne se connectent pas encore à OpenAPI. Dites-nous en démo que vous en avez besoin : les connecteurs les plus demandés passent en premier.

Questions

Toolify et OpenAPI en questions

Est-ce qu’OpenAPI fonctionne déjà avec Toolify ?

Pas encore. Aujourd’hui, aucun outil publié sur Toolify ne peut appeler une API extérieure, décrite en OpenAPI ou non, car les outils n’ont pas accès à Internet. Le connecteur est en préparation. Vous pouvez déjà repérer les descriptions OpenAPI de vos logiciels : elles serviront le jour venu.

Quelle différence entre OpenAPI et une API REST ?

Une API REST est la porte d’entrée elle-même : c’est par elle que les logiciels échangent. OpenAPI est le mode d’emploi qui la décrit : ce que l’on peut demander, comment, et ce que l’on reçoit. Une API REST peut exister sans description OpenAPI, mais elle est alors plus difficile à utiliser.

OpenAPI et OpenAI, est-ce la même chose ?

Non, malgré des noms très proches. OpenAPI est un format standard qui sert à décrire une API. OpenAI est l’entreprise américaine à l’origine de ChatGPT. Les deux n’ont aucun lien, et Toolify prépare un connecteur pour chacun.

Partagez votre prochain outil avec toute l’équipe

L’IA crée l’outil. Toolify le vérifie, le met en ligne et le partage avec les bonnes personnes.