Une API, pour Application Programming Interface, permet d'utiliser les ressources,
données ou fonctionnalités, d'une application web depuis une autre application. Les API
REST, en particulier, sont de plus en plus utilisées car elles fonctionnent de la même
manière que le reste du web !
REST s'est aujourd'hui imposé comme un standard car c'est une architecture simple
d'utilisation et plus facile à maintenir.
Le REST ne cesse de se démocratiser. Aujourd'hui, des entreprises comme Google,
Twitter ou Facebook en font usage pour leur API publique.
Qu’est-ce qu'une API ?
Dans votre vie de développeur, vous allez être amené à concevoir des applications
complexes. Imaginez que vous devez travailler sur une application permettant de louer
simplement un vélo, ou bien de déposer un avis sur un restaurant. Pour que votre
application soit vraiment utile, l’utilisateur doit pouvoir géolocaliser le vélo. Vous avez
donc besoin d'un service de géolocalisation. Vous avez donc deux options, vous pouvez
:
1. Passer des années avec plusieurs dizaines de développeurs à concevoir un
service de carte du monde et de géolocalisation.
2. Utiliser un service de géolocalisation déjà existant : ArcGIS, Waze, Open Street
Map, etc.
API est l’abréviation de “Application Programming Interface”. C'est une interface de
programmation, c'est-à-dire un ensemble de classes, de fonctions et de méthodes qui
servent de façade à un logiciel. D'autres logiciels pourront donc accéder aux services de
ce logiciel grâce à cette interface.
L’API permet de faciliter la communication entre 2 produits ou services, comme par
exemple votre application et un service de géolocalisation. L’API permet à ces 2
entités d’échanger des données sans en connaître les détails de mise en œuvre.
L’API permet donc un immense gain de temps pour les développeurs et un
gain d’argent pour les entreprises. L’API permet l’ouverture d’un produit au monde
extérieur !
Quelques exemples d'API
La majorité des logiciels utilisent les API : Facebook, Twitter, Snapchat, Shazam,
Netflix, ArcGIS sont des logiciels qui mettent à disposition des API et qui se basent sur
les API d'autres services !
• Le logiciel de géolocalisation et d’aide à la décision ArcGIS, produit par la société
Esri, met à disposition des développeurs plusieurs API pour vos projets
informatiques ! Cliquez ici pour consulter la liste des API ArcGIS disponibles !
• Le service de reconnaissance de musiques de Snapchat repose sur l'API de
Shazam.
• Le service de prise de rendez-vous de votre salle de sport préférée repose sur
l'API de Google Calendar.
• Le service d'authentification via Facebook de nombreuses applications utilise
l'API de Facebook.
Vous savez maintenant à quoi servent les API. Voyons maintenant comment elles
fonctionnent !
Comment fonctionne une API ?
Distinguez client et serveur
Pour fonctionner, une API a besoin d’un serveur et d’un client :
• un serveur est un ordinateur puissant permettant d’exécuter une API. C'est le
fournisseur du service, celui qui propose au client d'accéder à ses données ou
services ;
• un client est un programme qui échange les données avec un serveur à travers
l’API. C'est l'utilisateur de l'API. On parle plus couramment d'architecture client-
serveur.
Prenez l’exemple de géolocalisation d’une adresse.
À travers une application (le client), vous saisissez une adresse puis vous cliquez sur
un bouton pour vous localiser. Au moment du clic, un message contenant l’adresse
saisie est envoyé à un ordinateur puissant (le serveur) qui va vous renvoyer des
coordonnées pour localiser votre adresse dans votre application.
Rôle du client
Le client est la partie visible, la mise en forme de la réponse du serveur. Par exemple,
une carte avec des monuments : quand je clique sur un monument, j’obtiens les
informations de ce monument.
Le client initie l’échange avec le serveur. Il peut ainsi demander l’exécution d’un service.
Par exemple, je veux récupérer des informations à partir de la saisie d’un mot dans un
moteur de recherche.
Rôles du serveur
Le serveur est la partie invisible. Par exemple, le serveur peut être un serveur de calcul
(itinéraire, distance...), un serveur d’applications, un serveur de bases de données…
Le serveur représente le service rendu. Par exemple, envoyer les informations d’un
monument. La mise en forme sera réalisée par le client.
Le serveur est à l’écoute des requêtes du client. Le serveur peut répondre à plusieurs
clients en même temps.
En résumé, le client envoie une requête au serveur qui renvoie une réponse au client en
lien avec la requête ! Schématiquement, cela ressemble à :
Comment le client et serveur communiquent-ils ?
Généralement, le client et le serveur sont sur 2 machines différentes, mais il est possible
que les 2 soient sur la même machine.
Le client communique avec le serveur via un protocole appelé protocole client-serveur.
Un protocole est un ensemble de règles de communication entre des objets connectés.
Par exemple, les protocoles Bluetooth, POP (messagerie mail), HTTP (web)...
Le client envoie une requête au serveur qui renvoie une réponse au client. La requête
peut être un message codé ou non codé, un paramètre d’appel, une configuration de
service requis, etc.
En résumé, un fournisseur de service (serveur) met à disposition des développeurs une
interface codifiée, qui leur permet d’obtenir des informations à partir de requêtes. Sans
entrer dans les détails, la communication est la suivante :
• sur un site Web, le client envoie la requête suivante : "envoie-moi ton adresse
sous la forme X = rue, Y = ville ou code postal, Z = pays" ;
• le serveur répond par un code contenant des coordonnées X,Y de ton adresse à
afficher sur ton site.
Le schéma ci-dessous illustre bien cette communication. Le client envoie la requête au
serveur à travers une application. Le serveur exécute le service "localisation sur une
carte" de l'API. Puis le serveur envoie une réponse contenant les coordonnées X,Y pour
que l'application cliente se localise sur l'adresse saisie :
Utilisez les API dans vos projets de développement
Dès lors que vous souhaitez exécuter ou utiliser un service web, il est conseillé
d’utiliser une API. Par exemple, si vous développez une application qui a pour but de
connaître l’état du trafic routier, il est conseillé d’utiliser l’API de Waze pour éviter de
tout redévelopper par vous-même. D'autres entreprises se sont cassé la tête à
construire de superbes services accessibles via leur API, utilisez-les !
Pour la grande majorité des API disponibles sur le net, il vous sera demandé de
vous inscrire au préalable afin d’obtenir une clé ou token permettant d’accéder aux
données, aussi appelés ressources. Cette clé peut être un identifiant/mot de passe, une
suite de caractères ou une suite de nombres.
Par exemple, pour avoir accès à la ressource d’affichage de la carte FranceRaster, il
est nécessaire d’avoir une clé pour accéder aux données.
Sinon, comme vous pouvez le voir, l’URL renvoie une erreur HTTP 403 (non autorisé à
accéder au contenu).
Pour récapituler, une API est une interface d'un logiciel qui permet d'accéder aux
données d'autres services. Pour utiliser une API, le client (votre application, par
exemple) doit envoyer une requête au serveur (le fournisseur du service, celui qui a
construit l'API). Le serveur répondra donc avec les données demandées, si elles sont
accessibles et si le client a bien le droit d'y accéder. La communication entre les deux se
fait avec un protocole, comme par exemple HTTP.
Architecture REST
