Dev Back
06/08/2020
Laurent Buffevant
Vous avez déjà probablement entendu parler d’API. Mais qu’est-ce donc ? Quand et pourquoi en utiliser ? Quels sont les pièges à éviter ? Comment Studio HB peut vous accompagner dans la conception ou la consommation de vos API ?
Suivez le guide, c’est par ici!
Une API, Application Programming Interface - Interface de Programmation d’Application en français dans le texte - est couramment décrite comme un moyen pour faire communiquer 2 systèmes d’information. Ces systèmes d’information peuvent prendre différentes formes:
Concrètement, une API va par exemple être utilisée pour faire communiquer votre nouvelle application smartphone avec le serveur hébergeant vos données. La même API pouvant être utilisée par votre Site web pour récupérer et mettre à jour ces mêmes données. L’énorme avantage est que les différents systèmes d’informations peuvent être développés dans des langages complètements différents, l’API leur permettra de dialoguer et d’échanger dans une langue commune.
Une API se caractérise toujours par une interface d’entrée (input), et une de sortie (output). En clair, une API va permettre de recevoir une information afin d’en renvoyer une autre en réponse après l’avoir analysée et traitée.
Vous entendrez souvent le terme de passerelle, ou de webservice comme synonyme d’une API. C’est partiellement vrai. Un webservice va permettre la communication de 2 systèmes d’informations sur un réseau. L’API elle, va plus loin car elle va permettre l’interaction entre 2 systèmes qui peuvent être à l’intérieur d’une même application. Un webservice est par conséquent un type d’API. Il existe donc d’autres types d’API.
Par exemple, pour les plus techniques d’entre vous, on le sait moins mais ActionDispatch qui gère le routage des requêtes HTTP est une API qui permet d’accueillir en entrée une requête HTTP et de la diriger vers le bon Controller Rails. ActionController est ainsi lui même une API permettant de traiter les informations de la requête, d’appeler d’autres API (ApplicationRecord, Services, Policies, ActionView, etc… ) afin de renvoyer en retour un contenu (HTML, JSON, XML, CSV, etc…) que votre navigateur va pouvoir interpréter.
Ce n’est pas tout de vouloir mettre en place des API. Encore faut-il respecter certaines rêgles pour qu’elles soient efficaces et pertinentes.
Si vous souhaitez que votre API soit facilement utilisée (consommée) par le plus grand nombre il est nécessaire que celle-ci soit développée en suivant certaines normes et protocoles standardisés. Intéressons nous principalement aux API web qui sont celles que vous allez principalement rencontrer:
Pour être comprise une API doit nécessairement être documentée. Imaginez-vous au téléphone avec un correspondant ne parlant pas un mot de votre langue. Sans un dictionnaire permettant de traduire ce que vous voulez lui demander et ce qu’il va vous répondre, impossible de se comprendre. Avec une Application Programming Interface c’est la même chose. Il est impossible de la comprendre sans une bonne documentation. Celle-ci doit être découpée en plusieurs niveaux et sous-niveaux:
Vous l’aurez compris, chez Studio HB les API c’est notre pain quotidien. Pour nos clients dans l’immobilier par exemple, nous récupérons les biens en vente via une API mise à disposition par les éditeurs de logiciel immobilier (Apimo, Avantio, Hektor, etc…).
Pour nos projets nécessitant un paiement en ligne pour un achat ou un abonnement nous allons nous connecter aux API proposées par des banques (Monetico/CIC), ou des intermédiaires bancaires (Stripe, Systempay).
Et nous en utilisons pour bien d’autres fonctionnalités (Connexion Réseaux sociaux, Récupération de statistiques Google Analytics, affichage de cartes, etc… )
A l’inverse nous développons également des API pour vos projets afin de communiquer des informations vers l’exterieur ou échanger des données avec d’autres systèmes que vous seriez amené à vouloir utiliser. C’est le cas par exemple pour certains de nos clients dans l’immobilier où nous avons mis en place une API privée afin d’envoyer le descriptif de leurs programmes sur la plateforme de visite virtuelle Habiteo
Vous l’aurez compris l’équipe de Studio HB vous accompagnera pour la conception ou l’utilisation d’une API pour votre projet. N’hésitez pas à visiter notre site et nous contacter pour de plus amples informations.
restons connectés
Inscrivez vous à notre newsletter pour vous tenir informés de nos derniers articles et posts LinkedIn
newsletter
Agence web Lyon
22 rue de la République
69002 Lyon
Découvrez l'agence
Nos expertises
Nos dernières réalisations
Recrutement