Description des interfaces de programmation d'applications (API)

Vous pouvez être confronté à des défis lors de la transformation de votre entreprise en entreprise intelligente et durable. Par exemple, vous devez intégrer des applications et des processus de gestion dans une infrastructure diversifiée de systèmes basés sur le Cloud ou hybrides. Vous disposez également de solutions de fournisseurs non SAP, auquel cas vous devez intégrer des processus SAP à des processus non SAP. Vous pouvez utiliser SAP Integration Suite pour intégrer SAP aux processus SAP et non SAP à SAP. Votre entreprise peut également commercialiser et gérer vos API via SAP Integration Suite.

API est un acronyme pour "Application Programming Interface". Il est le médiateur (représenté par un logiciel) entre les applications/sites Web et vous en tant qu'utilisateur. Par conséquent, il est essentiel pour la communication entre les différentes instances d'échanger des informations.

Vous rencontrez des API dans la vie quotidienne sans que vous vous en rendiez compte. Un exemple est Google Search : Chaque fois que vous entrez quelque chose dans la barre de recherche, le service backend de Google recherche vos mots-clés dans sa base de données et répertorie les résultats de votre demande sur le site Web. En fait, le site Web affiche le résultat de l'API. L'URL de la recherche correspondante est un code à cet effet.

Lorsque vous envisagez de rechercher "SAP", l'URL indique : www.google.com/search?q=sap.

Maintenant, venons-en à la tranche suivante :

Ici www.google.com est l'adresse du serveur, /search indique la fonctionnalité que vous avez l'intention d'utiliser, ou mieux, l'API que vous voulez appeler, qui dans ce cas est l'API Google Search, et q (pour query) lui indique qu'une valeur pour la requête est maintenant transmise, qui est le terme de recherche.

Il en va de même pour la page d'aide de SAP (https://help.sap.com ). Lors de la saisie de l'API dans la barre de recherche, l'URL suivante apparaît : https://help.sap.com/docs/search?q=api.

Cependant, un appel d'API ne doit pas nécessairement être initié par un ordinateur. Les systèmes d'assistance vocale sont également un exemple d'intégration et d'utilisation d'API. Demander à votre assistant vocal de rechercher quelque chose fournit réellement votre requête à l'assistant. Cette requête est ensuite stockée sous forme de texte et ajoutée en tant que requête à l'appel d'API. Ensuite, l'assistant donne le résultat de l'API via la voix audio.

Ainsi, peu importe ce que vous faites avec l'un de vos appareils connectés, vous utilisez plusieurs API par heure sans vous en apercevoir. C'est pourquoi les API sont un sujet si important, car elles sont omniprésentes et permettent aux utilisateurs et aux développeurs de se concentrer sur ce qu'il faut faire et non sur « comment ». En outre, avez-vous déjà pensé à la manière dont votre message WhatsApp est envoyé à un destinataire ?

Par conséquent, comme son nom l'indique, une API n'est qu'un des nombreux types d'interfaces utilisées pour déclencher des fonctions spécifiques, par exemple, la lecture de musique. Vous connaissez peut-être déjà d'autres types d'interfaces, telles que l'interface utilisateur graphique (GUI), que nous utilisons pour naviguer entre les applications/sites Web à l'aide d'une souris/d'un écran tactile.

Les API sont indispensables pour les architectures informatiques de nos jours. Bien que l'accès du front-end au back-end, à la gestion des interfaces et à la communication point à point soit une part importante des architectures informatiques depuis des années, les API ont révolutionné la façon dont les applications et les sites Web communiquent. Par conséquent, les API ont apporté de nombreux avantages à la création et à la gestion d'infrastructures informatiques. Les principales, et donc les principales raisons pour lesquelles les entreprises doivent les implémenter dans leur architecture informatique, peuvent être résumées comme suit :

Les API, au cœur, séparent la communication de la tâche. Ainsi, si un service communique via une API, l'utilisateur (ou le consommateur) de l'API est entièrement axé sur les fonctionnalités fournies par l'API. L'utilisateur utilise uniquement les fonctionnalités de l'API sans penser au job lui-même. L'accent est mis sur la demande et le résultat (réponse) et rien d'autre.

Pour la définition et l'implémentation d'API, différentes normes globales peuvent être utilisées. Certaines d'entre elles sont répertoriées ci-dessous (cependant, les plus couramment utilisées sont les API REST) :

Avec les API REST comme type d'API le plus populaire, nous allons brièvement approfondir les fonctions des API REST. Lorsque vous utilisez des API, vous parlez généralement de ressources. Cela signifie que vous voulez généralement :

• Créez quelque chose (comme l'ajout d'une nouvelle entrée à un livre d'or).
• Lisez ou obtenez quelque chose de l'API (souvenez-vous de votre recherche Google: ici, vous avez essayé d'obtenir une liste de sites Web).
• Mettre à jour ou modifier quelque chose (généralement lorsque vous avez créé quelque chose qui doit être modifié, comme le statut de quelque chose ou si vous avez fait une faute de frappe).
• Supprimez quelque chose.

Ensemble, ces actions sont abrégées en: CRUD.

Pour les API REST, ces verbes sont très similaires aux verbes CRUD :

Vous pouvez remarquer que "update" a deux verbes possibles: PUT & PATCH.

Le correctif modifie uniquement une partie de la ressource à laquelle vous faites référence. Pensez à votre entrée de livre d'invité, où vous corrigez un seul mot et informeriez le livre d'invité que le mot numéro 42 doit être échangé. Ce serait un patch - un endroit sur la réparation ou le changement. PUT, en revanche, serait changer l'ensemble du texte, même s'il est surtout le même, mais avec l'erreur corrigée (pensez à effacer l'ensemble du texte et à tout coller à nouveau).

En règle générale, lorsque vous consultez la spécification d'une API, ces verbes sont affichés comme illustré ci-dessous (récupérés à partir d'un exemple de déploiement dans SAP BTP Integration Suite). Une API ne prend pas nécessairement en charge tous les verbes.