Qu'est-ce qu'une API ?

Une API (Application Programming Interface) est un ensemble de règles et de spécifications qui permettent aux logiciels de communiquer entre eux. Il s’agit d’un « langage » commun utilisé par deux programmes pour échanger des informations.

La métaphore du restaurant

Les clients passent leurs commandes et les chefs préparent les plats. L’API est comme un serveur, transmettant la commande du client au chef, puis servant les plats préparés au client. Le client (un logiciel) n’a aucune idée de la façon dont le chef (un autre logiciel) prépare le plat, il passe simplement la commande et reçoit le plat.

Exemples d’utilisation des API

Paiement en ligne

Des services de paiement en ligne comme PayPal ou Stripe proposent des API qui permettent aux développeurs d’intégrer des fonctionnalités de paiement dans leurs applications.

Cartographie et géolocalisation

Google Maps et Mapbox permettent aux développeurs d’intégrer des fonctionnalités de cartographie et de navigation dans leurs applications : recherche d’adresses, tracé d’itinéraires, affichage de cartes interactives, etc.

Réseaux sociaux

Facebook, Twitter, Instagram et LinkedIn permettent aux développeurs d’intégrer des fonctionnalités sociales dans leurs applications : partage de contenu, accès aux profils d’utilisateurs, récupération de publications, etc.

Les différents types d’API

API Web

Les API Web sont largement répandues et utilisent généralement les principes de l’architecture REST (Representational State Transfer). Les données sont souvent échangées dans des formats standardisés :

• JSON (JavaScript Object Notation)
• XML (eXtensible Markup Language)

Les API RESTful sont idéales pour les applications web et mobiles.

API SOAP

Les API SOAP (Simple Object Access Protocol) sont basées sur un protocole plus ancien et utilisent XML pour échanger des informations structurées entre les différentes parties.

Les API SOAP sont généralement utilisées dans les environnements d’entreprise qui nécessitent des fonctionnalités avancées de sécurité et de gestion des erreurs. Elles sont plus complexes à mettre en œuvre et à maintenir que les API REST, mais elles offrent une plus grande flexibilité dans la définition des services et des opérations.

API GraphQL

GraphQL est un langage de requête API développé par Facebook. À l’aide de GraphQL, les clients peuvent interroger le schéma de données pour récupérer exactement les informations dont ils ont besoin.

Cela permet aux développeurs d’éviter plusieurs requêtes et d’optimiser les performances des applications.