Les API et l'API Manager
L’API Manager est l’interface qui permet d’ajouter et paramétrer les connecteurs API que votre assistant utilise dans les Smart Skill.
Vous pouvez à tout moment voir la liste des API disponibles, et modifier leurs paramètres.
Qu’est-ce qu’une API ?
Une API, ou interface de programmation d'application, est un ensemble de définitions et de protocoles qui facilite la création et l'intégration des applications.
Les API permettent à votre produit ou service de communiquer avec d'autres produits et services sans connaître les détails de leur mise en œuvre.
Les API constituent un moyen simplifié de connecter votre propre infrastructure au travers du développement d'applications cloud-native. Elles vous permettent également de partager vos données avec vos clients et d'autres utilisateurs externes.
Même si de bonnes pratiques existent, chaque API est différente, il faut alors se référer à leur documentation. Tel une notice, ce document vous permet de comprendre ce que l’API peut permettre et ce qu’elle attends afin de faire ceci.
Par exemple: Vous voulez récupérer la température à Paris. Vous allez sélectionner une API qui peut vous donner cette information, cependant elle attendra que vous lui donniez le nom de la ville, le code postal ou les coordonnées afin de vous communiquer la température de cette ville.
Une API c’est donc
Une interface vers un service externe
Une documentation, une notice d’utilisation
Un périmètre fonctionnel
Des informations attendues en entrée, contre des informations en sortie
Vous voulez en savoir plus ? https://api.gouv.fr/guides/api-definition