Description des interfaces de programmation d'applications (API)

Vous devrez peut-être relever certains défis en transformant votre entreprise en une entreprise intelligente et durable. Par exemple, vous devez intégrer des applications et des processus de gestion dans un environnement diversifié 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 des processus SAP à SAP et des processus non SAP à SAP. Votre entreprise peut également commercialiser et gérer vos API via SAP Integration Suite.

API est un acronyme de "Application Programming Interface". C'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 de tous les jours sans que vous vous en rendiez compte. Un exemple est Google Search : chaque fois que vous saisissez 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. Il s'agit de l'URL de la recherche correspondante.

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

Découpons celle-ci :

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 de recherche Google, et q (pour requête) lui indique que maintenant une valeur pour la requête est transférée, 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 s'affiche : 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 à l'assistant votre requête. Cette requête est ensuite stockée sous forme de texte et ajoutée en tant que requête à l'appel d'API. Par la suite, 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 qui" doit être fait et non sur "comment". Aussi, avez-vous déjà pensé à la façon 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és pour déclencher des fonctions spécifiques, par exemple, la lecture de musique. Il se peut que vous soyez déjà familiarisé avec d'autres types d'interfaces, comme l'interface utilisateur graphique (GUI), que nous utilisons pour naviguer entre les applications/sites Web à l'aide d'une souris/d'un écran tactile.

De nos jours, les API sont indispensables pour les architectures informatiques. Bien que l'accès des front-ends aux back-ends, la gestion des interfaces et la communication point à point constituent depuis des années une part importante des architectures informatiques, 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'environnements informatiques. Les plus importantes, et donc les raisons clés 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 se concentre entièrement 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. Le focus est basé sur la demande et le résultat (réponse) et rien d'autre.

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

Avec les API REST comme type d'API le plus populaire, nous allons explorer brièvement les fonctions des API REST. Lorsque vous travaillez avec 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'hôtes).
• 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).
• Mettez à jour ou modifiez 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'hôtes, où vous corrigez un seul mot et informeriez le livre d'hôtes que le mot numéro 42 doit être échangé. Il s'agirait d'un patch - une tache de réparation ou de changement. PUT, en revanche, changerait tout le texte, même s'il est surtout le même, mais avec l'erreur corrigée (pensez à effacer tout le 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.