Une API REST est une manière d'organiser le dialogue entre deux logiciels qui communiquent à travers le Web : l'un pose une question en visant une adresse précise, l'autre répond en renvoyant des données, le plus souvent dans un format texte facile à lire comme le JSON. Derrière ce sigle un peu intimidant se cache un mécanisme que chacun utilise des dizaines de fois par jour sans le savoir : lorsque votre application météo affiche les prévisions, lorsqu'un site marchand calcule les frais de livraison ou qu'une carte s'affiche dans une page, ce sont très souvent des requêtes REST qui circulent en coulisses. Le terme réunit deux notions distinctes. L'API, pour Application Programming Interface, désigne l'interface qu'un programme met à disposition des autres. REST, pour Representational State Transfer, est un style d'architecture défini au tournant des années 2000 qui fixe quelques règles simples pour que ces échanges restent cohérents, rapides et faciles à faire évoluer. D'autres approches existent pour bâtir des services web, comme le protocole OData, qui s'appuie d'ailleurs sur les principes REST pour standardiser l'interrogation de données. Cette définition explique ce qu'est une API, d'où vient REST, comment fonctionne concrètement une requête et en quoi ce style diffère de son aîné SOAP.

Qu'est-ce qu'une API ? Le socle de toute API REST

Avant de parler de REST, il faut comprendre ce qu'est une interface de programmation. Une API est un ensemble de règles et de points d'entrée qu'un logiciel publie pour permettre à d'autres programmes de lui demander un service, sans avoir besoin de connaître son fonctionnement interne. L'image la plus parlante reste celle du restaurant : le client ne va pas en cuisine, il consulte un menu et passe commande auprès d'un serveur, qui transmet la demande puis rapporte le plat. Le menu correspond à la documentation de l'API, qui liste ce que l'on peut demander et sous quelle forme ; le serveur joue le rôle de l'interface ; la cuisine représente le programme qui fait réellement le travail. Ce principe d'intermédiaire normalisé présente un double avantage : le programme appelant n'a pas à se soucier des détails techniques de l'autre, et le programme appelé peut changer sa « recette » interne sans casser les applications qui l'utilisent, tant que le menu reste le même. Les API existent partout, à l'intérieur d'un ordinateur (le système d'exploitation en propose aux applications) comme entre des machines éloignées. Une API REST est simplement une API web, accessible par le réseau, qui respecte les principes du style REST.

D'où vient l'API REST ? Roy Fielding et la naissance de REST

Le style REST a été décrit en 2000 par l'informaticien américain Roy Fielding dans sa thèse de doctorat, soutenue à l'université de Californie à Irvine. Fielding n'était pas un inconnu : il avait participé à l'écriture des spécifications du protocole HTTP, celui qui transporte les pages web, et figurait parmi les fondateurs du projet de serveur Apache. Dans sa thèse, il ne propose pas un nouveau logiciel ni une norme à installer, mais une analyse des raisons pour lesquelles le Web avait si bien réussi à grandir, puis une liste de contraintes d'architecture qui résument ces bonnes pratiques. L'idée centrale est que le Web manipule des « ressources » (un article, un produit, un utilisateur) identifiées par des adresses, et que l'on échange des « représentations » de ces ressources, par exemple une page HTML ou un document JSON, d'où le nom de transfert d'état représentationnel. Au cours des années 2000, les grands services en ligne ont progressivement ouvert des API construites sur ce modèle, plus légères que les solutions de l'époque. L'essor des smartphones et des applications mobiles, gourmandes en échanges rapides avec des serveurs, a ensuite fait de REST l'approche dominante pour les services web publics.

Roy Fielding, informaticien américain qui a défini le style d'architecture REST dans sa thèse en 2000

Comment fonctionne une API REST ? Requêtes, ressources et réponses

Le fonctionnement d'une API REST repose sur le protocole HTTP, le même que celui de votre navigateur. Chaque ressource possède une adresse unique, appelée URL ou endpoint (point d'accès), par exemple une adresse se terminant par « /produits/42 » pour désigner le produit numéro 42. Le programme client envoie une requête vers cette adresse en précisant un verbe HTTP qui indique l'action souhaitée : GET pour lire, POST pour créer, PUT ou PATCH pour modifier, DELETE pour supprimer. La requête peut contenir des en-têtes (informations techniques comme le format attendu ou une clé d'accès) et, pour une création ou une modification, un corps de message avec les données à enregistrer. Le serveur traite la demande puis renvoie une réponse composée d'un code de statut à trois chiffres et, le plus souvent, d'un document JSON. Ces codes sont standardisés : 200 signifie que tout s'est bien passé, 201 qu'une ressource a été créée, 404 que la ressource n'existe pas, 401 que l'accès n'est pas autorisé, 500 qu'une erreur s'est produite côté serveur. Cette grammaire commune permet à n'importe quel développeur de comprendre rapidement une API qu'il découvre.

Schéma animé d'un échange REST : une application envoie une requête GET vers une URL, le serveur répond avec un code 200 et des données JSON Un échange REST en deux temps Appli météo 18 °C Client API REST Serveur GET /meteo/arras 200 OK + JSON 1. requête : verbe + adresse 2. réponse : code + données {"ville":"Arras","temp":18}
Le client envoie une requête HTTP vers l'adresse d'une ressource ; le serveur renvoie un code de statut et une représentation de la ressource, ici au format JSON.

Quels sont les grands principes d'une API REST ?

Pour qu'une interface mérite vraiment le nom d'API REST, elle doit respecter les contraintes décrites par Fielding. La première est la séparation client-serveur : le client s'occupe de l'affichage et de l'interaction avec l'utilisateur, le serveur stocke et traite les données, et chacun peut évoluer indépendamment. Vient ensuite l'absence d'état, ou stateless : chaque requête doit contenir toutes les informations nécessaires pour être comprise, le serveur ne gardant aucun souvenir de la conversation précédente. Cela simplifie énormément la répartition de la charge entre plusieurs machines, puisque n'importe quel serveur peut répondre à n'importe quelle requête. Les réponses doivent aussi indiquer si elles peuvent être mises en cache, c'est-à-dire conservées temporairement pour éviter de reposer la même question. L'interface uniforme impose des conventions communes : des ressources identifiées par des URL, des verbes HTTP standard, des messages qui se décrivent eux-mêmes. L'architecture peut en outre être organisée en couches (passerelles, caches, répartiteurs) invisibles pour le client. Une dernière contrainte, facultative, autorise le serveur à envoyer du code exécutable au client. Dans la pratique, beaucoup d'API dites REST n'appliquent qu'une partie de ces règles, d'où l'expression parfois employée d'API « RESTful » pour celles qui les suivent fidèlement.

Verbe HTTPAction sur la ressourceExemple de requêteRéponse typique
GETLire une ressource ou une listeGET /produits/42200 OK avec les données du produit
POSTCréer une nouvelle ressourcePOST /produits201 Created avec l'adresse du nouveau produit
PUTRemplacer entièrement une ressourcePUT /produits/42200 OK ou 204 No Content
PATCHModifier une partie d'une ressourcePATCH /produits/42 (nouveau prix)200 OK avec la ressource mise à jour
DELETESupprimer une ressourceDELETE /produits/42204 No Content, ou 404 si elle n'existe pas

Les formats de données échangés

Le style REST n'impose aucun format particulier pour les données, mais l'usage a tranché en faveur du JSON, pour JavaScript Object Notation. Ce format texte organise l'information en paires « nom : valeur » regroupées entre accolades, ce qui le rend lisible par un humain et très facile à traiter par les programmes, notamment dans les navigateurs. Une fiche produit renvoyée par une API ressemble ainsi à une petite liste structurée indiquant un identifiant, un nom, un prix et une disponibilité. Le XML, plus ancien et plus bavard avec ses balises ouvrantes et fermantes, reste utilisé dans certains secteurs comme la banque, l'administration ou l'échange de documents, et une même API peut proposer les deux formats en fonction de ce que le client demande dans l'en-tête de sa requête. D'autres représentations sont possibles, du simple texte aux images en passant par le CSV pour des tableaux de données. Ce découplage entre la ressource et sa représentation est justement au cœur de la philosophie REST : un même produit peut être « montré » sous plusieurs formes selon les besoins, sans que son identité, matérialisée par son adresse, ne change. Les documentations modernes décrivent souvent ces échanges avec la spécification OpenAPI, qui sert à la fois de mode d'emploi et de contrat.

À quoi sert une API REST ? Exemples d'utilisation au quotidien

Les usages de l'API REST sont si nombreux qu'il est difficile de trouver un service numérique qui n'en dépende pas. Les applications mobiles en sont les premières utilisatrices : l'écran que vous consultez sur votre téléphone n'est souvent qu'une vitrine qui interroge en permanence le serveur de l'éditeur pour afficher votre fil d'actualité, vos messages ou votre solde bancaire. Les sites de commerce en ligne s'appuient sur des API pour vérifier un paiement, suivre un colis chez le transporteur ou synchroniser leurs stocks avec un logiciel de gestion. Les cartes interactives, les widgets de réseaux sociaux, les comparateurs de prix ou les agrégateurs de vols reposent sur le même principe d'interconnexion de services. Dans les entreprises, les API REST relient entre eux des outils autrefois cloisonnés : logiciel de facturation, outil de relation client, plateforme d'e-mailing. Les objets connectés y ont aussi recours pour transmettre leurs mesures, tout comme les services d'intelligence artificielle accessibles en ligne, que les développeurs interrogent par de simples requêtes HTTP. Enfin, de nombreuses administrations et collectivités publient des données ouvertes au travers d'API publiques, permettant à chacun de construire des services à partir d'horaires de transport, d'adresses ou de statistiques.

Sécuriser une API REST

Ouvrir un logiciel au monde extérieur impose de contrôler qui peut l'utiliser et pour faire quoi. La première protection d'une API REST est le chiffrement des échanges grâce au HTTPS, qui empêche un tiers de lire ou de modifier les données en transit. Vient ensuite l'authentification : la méthode la plus simple consiste à fournir une clé d'API, sorte de mot de passe propre à chaque application cliente, transmise dans un en-tête de la requête. Les services plus exigeants utilisent des jetons d'accès temporaires délivrés selon le protocole OAuth 2.0, celui qui vous permet par exemple de vous connecter à un site avec votre compte d'un grand service sans lui confier votre mot de passe. Les fournisseurs appliquent aussi des limites de débit, qui plafonnent le nombre de requêtes autorisées sur une période donnée pour éviter les abus et protéger leurs serveurs. Côté serveur, chaque donnée reçue doit être vérifiée avant d'être enregistrée, afin d'éviter les injections de code malveillant. Enfin, une bonne pratique consiste à versionner l'API, par exemple avec un préfixe « /v1/ » dans les adresses, pour pouvoir la faire évoluer sans casser les applications déjà en circulation.

API REST ou SOAP : quelles différences entre ces deux approches ?

Avant l'essor de REST, les services web reposaient largement sur SOAP, pour Simple Object Access Protocol, un protocole standardisé qui encode tous ses messages en XML dans une « enveloppe » aux règles strictes. Là où REST est un style d'architecture souple centré sur les ressources, SOAP est un protocole formel centré sur les opérations : on n'y manipule pas un produit à une adresse donnée, on appelle une fonction nommée, comme « obtenirPrixProduit », décrite dans un contrat technique appelé WSDL (Web Services Description Language). Cette rigueur a des avantages réels : SOAP intègre des normes poussées pour la sécurité des messages, les transactions et la fiabilité, ce qui explique sa présence persistante dans la banque, l'assurance, les télécommunications ou les échanges avec certaines administrations. En contrepartie, ses messages sont plus volumineux et plus longs à écrire comme à traiter, ce qui le rend moins adapté aux applications mobiles et aux interfaces web rapides. REST, qui utilise directement les mécanismes du Web, se montre plus léger, plus simple à tester avec un navigateur ou un outil en ligne de commande, et profite pleinement du cache. Le choix dépend donc du contexte, et pour approfondir l'approche historique, vous pouvez consulter notre page consacrée à SOAP, qui détaille son fonctionnement.