Aller au contenu
Encyclopédie informatique Édition 2026

Les API et les services web

Partie 3 sur 3

Niveau de lecture :

7Les API Web d’aujourd’hui : REST

7.1Le principe

En 2000, dans sa thèse de doctorat, l’informaticien américain Roy Fielding, l’un des auteurs du protocole HTTP, a décrit le style d’architecture qui fait le succès du Web, qu’il a appelé REST (Representational State Transfer, « transfert d’un état par sa représentation »). Ses principes ont été repris pour concevoir des API beaucoup plus simples que SOAP :

  • tout ce que l’API manipule est une ressource, désignée par une adresse Web, son URL (voir les URL) : /clients/42 désigne le client numéro 42, /clients/42/commandes ses commandes ;
  • on agit sur les ressources avec les méthodes ordinaires de HTTP, toujours les mêmes, au lieu d’inventer une fonction par opération (tableau 1) ;
  • le serveur renvoie une représentation de la ressource, le plus souvent en JSON ;
  • chaque requête est sans état : elle contient tout ce qu’il faut pour être traitée, notamment la preuve de l’identité de l’appelant, ce qui permet de répartir les requêtes sur autant de serveurs que nécessaire.
Tableau 1. Les principales méthodes HTTP utilisées par les API REST.
MéthodeUsageExemple
GETlire une ressource ou une liste, sans rien modifierGET /clients/42
POSTcréer une nouvelle ressource dans une collectionPOST /clients
PUTremplacer entièrement une ressourcePUT /clients/42
PATCHmodifier une partie d’une ressourcePATCH /clients/42
DELETEsupprimer une ressourceDELETE /clients/42

7.2Une requête, une réponse

Une requête REST est une requête HTTP ordinaire, comme celle qu’envoie un navigateur pour afficher une page (figure 3). La réponse commence par un code à trois chiffres qui indique le résultat (tableau 2), suivi d’en-têtes et des données. On peut essayer une API depuis la ligne de commande avec l’outil curl, qui envoie des requêtes Web :

curl -H "Authorization: Bearer $JETON" \
     https://api.example.org/v1/villes/lyon/previsions

{"ville": "Lyon", "date": "2026-10-23",
 "temp": 18, "ciel": "nuageux"}
application (client) serveur api.example.org REQUÊTE GET /v1/villes/lyon/previsions Host: api.example.org Authorization: Bearer eyJh… Accept: application/json ← méthode + ressource ← serveur visé ← jeton d’accès ← format souhaité RÉPONSE HTTP/1.1 200 OK Content-Type: application/json {"ville": "Lyon",  "temp": 18, "ciel": "nuageux"} ← code : succès ← format des données ← les données en JSON Une requête HTTP ordinaire ; la réponse porte un code et des données.
Figure 3. Une requête et une réponse d’API REST. Le jeton d’accès, transmis à chaque requête, prouve l’identité et les droits de l’appelant.
Tableau 2. Les codes de réponse HTTP les plus courants dans les API.
CodeSignification
200succès ; la réponse contient les données demandées
201ressource créée
204succès, sans contenu à renvoyer (par exemple après une suppression)
400requête mal formée : paramètre manquant ou invalide
401identité non prouvée : jeton absent, invalide ou expiré
403identité connue, mais droits insuffisants
404ressource introuvable
429trop de requêtes : quota dépassé, il faut patienter
500, 503erreur du serveur, ou service temporairement indisponible

7.3Bien concevoir une API

Quelques règles font une API agréable et durable : des noms de ressources clairs et réguliers, au pluriel ; des réponses paginées, qui renvoient les longues listes par morceaux, avec un lien vers la page suivante ; des filtres passés en paramètres (/commandes?statut=livree) ; des messages d’erreur explicites, mais qui ne révèlent rien du fonctionnement interne ; un numéro de version dans l’adresse ou un en-tête ; et une conception qui part des besoins de ceux qui l’utiliseront, plutôt que de la structure de la base de données. Beaucoup d’API dites REST ne respectent qu’une partie des principes de Fielding ; l’essentiel est d’être cohérent et bien documenté.

Pour s’exercer

Exercice 1 : concevoir les adresses d’une API

Une médiathèque veut une API pour gérer son catalogue. Indiquez la méthode et l’adresse pour : a) lister les livres ; b) consulter le livre numéro 42 ; c) ajouter un livre ; d) corriger le titre du livre 42 ; e) retirer le livre 42 du catalogue. Quel code de réponse attendre en cas de succès pour c et e ?

Voir la réponse

a) GET /livres, avec pagination ; b) GET /livres/42 ; c) POST /livres, avec la description du livre en JSON dans le corps de la requête ; d) PATCH /livres/42, avec le seul champ modifié ; e) DELETE /livres/42. En cas de succès, c renvoie 201, ressource créée, généralement avec l’adresse du nouveau livre ; e renvoie 204, sans contenu. On n’écrit pas /ajouterLivre ou /supprimerLivre?id=42 : en REST, l’action est portée par la méthode, l’adresse ne désigne que la ressource.

Exercice 2 : interpréter les codes de réponse

Quel code une API bien conçue renvoie-t-elle dans chacun des cas suivants ? a) le jeton d’accès a expiré ; b) un client authentifié demande la facture d’un autre client ; c) une application interroge le service trente fois par seconde alors que son contrat en autorise dix ; d) la date fournie est « 31/02/2026 ».

Voir la réponse

a) 401 : l’identité n’est plus prouvée, l’application doit obtenir un nouveau jeton. b) 403, ou 404 si l’on préfère ne pas révéler l’existence de la facture ; en aucun cas 200 avec la facture (voir l’exercice 6). c) 429, accompagné si possible d’un en-tête Retry-After qui indique combien de temps attendre. d) 400, avec un message qui précise que la date est invalide.

Exercice 3 : de SOAP à REST

Réécrivez l’appel SOAP de la section 5.3 sous forme de requête REST. Que deviennent l’enveloppe et le fichier WSDL ?

Voir la réponse

La requête devient GET /v1/villes/lyon/previsions : la ville passe dans l’adresse de la ressource, l’opération « Prevision » est portée par la méthode GET, appliquée à la ressource « prévisions ». L’enveloppe disparaît : les informations techniques de l’en-tête SOAP, comme l’authentification, passent dans les en-têtes HTTP, et la réponse est un simple objet JSON. Le fichier WSDL est remplacé par une description OpenAPI. Le message tient en une ligne au lieu de sept, ce qui explique en bonne partie le succès de REST.

Exercice 4 : compatible ou non ?

Une API météo renvoie {"ville": "Lyon", "temp": 18}. Lesquelles de ces évolutions risquent de casser les applications existantes ? a) ajouter un champ "vent": 12 ; b) renommer temp en temperature ; c) renvoyer "18", une chaîne de caractères, au lieu du nombre 18 ; d) rendre obligatoire un nouveau paramètre pays ; e) ajouter une ressource /alertes.

Voir la réponse

a) et e) sont compatibles : les applications existantes ignorent le nouveau champ et n’appellent pas la nouvelle ressource, à condition d’avoir été écrites pour tolérer les champs inconnus. b), c) et d) sont incompatibles : une application qui lit temp ne trouve plus rien, une autre qui additionne des températures obtient une erreur ou concatène des textes, et toutes les requêtes sans pays sont rejetées. Ces changements imposent une nouvelle version majeure, /v2/, l’ancienne restant disponible pendant une période de transition annoncée. Pour d), on peut aussi rendre le paramètre facultatif, avec une valeur par défaut.

Exercice 5 : respecter un quota

Votre contrat avec un service de données boursières autorise 1 000 requêtes par heure. Votre script interroge le cours d’une action toutes les deux secondes. Que se passe-t-il, et au bout de combien de temps ? Comment faire mieux ?

Voir la réponse

Une requête toutes les deux secondes donne 1 800 requêtes par heure. Le quota de 1 000 est atteint après 1 000 × 2 = 2 000 secondes, soit environ 33 minutes ; les requêtes suivantes reçoivent le code 429 jusqu’au renouvellement du quota. Pour faire mieux : interroger moins souvent, une requête toutes les quatre secondes en donne 900 par heure ; demander plusieurs actions en une seule requête si l’API le permet ; garder en mémoire, en cache, les réponses qui changent peu ; utiliser un webhook ou un flux en temps réel si le service en propose ; et, en cas de code 429, attendre le délai indiqué au lieu de réessayer immédiatement, ce qui aggraverait la situation.

Exercice 6 : la commande du voisin

Connecté à votre compte sur une application de commerce, vous consultez votre commande à l’adresse /api/commandes/1042. Par curiosité, un utilisateur remplace 1042 par 1043 et obtient la commande d’un autre client, avec son nom et son adresse. Quel est le défaut ? Comment le corriger ?

Voir la réponse

L’API vérifie que l’utilisateur est connecté, mais pas que la commande demandée lui appartient : c’est un défaut de contrôle d’autorisation au niveau de chaque objet, la première faiblesse du classement de l’OWASP consacré aux API (voir le coin cyber). La correction se fait sur le serveur : à chaque requête, avant de renvoyer une commande, vérifier que son propriétaire est bien l’utilisateur identifié par le jeton, et répondre 403 ou 404 sinon. Utiliser des identifiants difficiles à deviner, plutôt que des numéros qui se suivent, complique l’exploitation mais ne remplace pas cette vérification. Des tests automatiques doivent la contrôler pour chaque ressource, et la surveillance doit repérer un utilisateur qui parcourt des centaines de numéros à la suite. Un tel défaut constitue en outre une violation de données personnelles, à signaler à la CNIL (Commission nationale de l’informatique et des libertés).

8Décrire, publier, gouverner

8.1OpenAPI, l’héritier de WSDL

REST ne prévoyait pas de format de description. La spécification OpenAPI, issue de l’outil Swagger et confiée en 2015 à un consortium hébergé par la Fondation Linux, a comblé ce manque : un fichier au format JSON, ou YAML, un format texte voisin plus facile à lire, décrit toutes les ressources d’une API, ses méthodes, ses paramètres, ses réponses et ses règles d’authentification. Comme WSDL autrefois, il permet de générer une documentation interactive, où l’on peut essayer les appels, du code client pour de nombreux langages, et des tests automatiques. Beaucoup d’équipes écrivent désormais ce contrat avant le code, une démarche dite « API d’abord ».

8.2Les passerelles d’API

Une organisation qui publie de nombreuses API les place généralement derrière une passerelle (en anglais API gateway), un point d’entrée unique qui vérifie l’identité des appelants, applique les quotas (un nombre maximal d’appels par minute ou par jour), transforme éventuellement les requêtes, met en cache les réponses fréquentes et journalise tous les appels. Elle fournit aussi un portail où les développeurs s’inscrivent, obtiennent leurs clés et consultent la documentation.

8.3L’économie des API

Les API sont devenues un modèle économique : on paie un service de cartographie, de paiement ou d’intelligence artificielle à l’appel ou par abonnement. Elles sont aussi un outil de politique publique. L’État français publie sur le site api.gouv.fr un catalogue de ses API, des adresses postales aux données des entreprises, et ses administrations échangent des informations par API pour éviter de redemander aux usagers des justificatifs qu’elles détiennent déjà. En Europe, la deuxième directive sur les services de paiement, dite DSP2, adoptée en 2015, a obligé les banques à ouvrir à des prestataires agréés, avec l’accord du client, des API d’accès aux comptes, ce qui a permis l’essor des applications d’agrégation de comptes et de paiement.

9Au-delà de RESTApprofondir

REST n’est pas la seule façon de concevoir une API distante. Plusieurs styles coexistent, chacun adapté à certains usages (tableau 3) :

  • GraphQL, créé par Facebook pour ses applications mobiles et publié en 2015, offre une adresse unique à laquelle le client envoie une requête qui décrit exactement les données voulues, champ par champ, éventuellement réparties entre plusieurs ressources ; il évite ainsi de multiplier les appels ou de recevoir des données inutiles ;
  • gRPC, publié par Google en 2015, renoue avec l’appel de procédure à distance, mais avec des messages binaires compacts, décrits dans le format Protocol Buffers, et le protocole HTTP/2 ; très efficace, il est surtout utilisé entre microservices, à l’intérieur d’un centre de données ;
  • les webhooks inversent le sens de l’appel : au lieu d’interroger régulièrement un service pour savoir si quelque chose a changé, on lui donne une adresse qu’il appellera lui-même lorsqu’un événement se produit, par exemple la confirmation d’un paiement ;
  • les WebSockets ouvrent une connexion permanente dans les deux sens entre un navigateur et un serveur, pour les messageries, les jeux ou les tableaux de bord en temps réel (voir les sockets).
Tableau 3. Les principaux styles d’API distantes.
StyleApparitionFormat des messagesUsage typique
XML-RPC1998XMLpour mémoire ; anciens outils de publication
SOAP1998-2003XML, enveloppe normaliséesystèmes d’entreprise des années 2000, banques, administrations
REST2000JSON le plus souventAPI publiques, applications Web et mobiles
GraphQL2015JSONapplications aux besoins de données variés
gRPC2015binairecommunication interne entre microservices
Sécurité de l’information

Le coin cyber

Les applications mobiles, les sites modernes et les objets connectés ne sont plus que des façades : derrière, ce sont les API qui donnent accès aux données. Elles sont devenues l’une des principales surfaces d’attaque des organisations. Les attaques sont décrites ici dans leur principe seulement.

C.1Une porte d’entrée vers les données

On a longtemps vu un avantage dans le fait que les services Web passent par HTTP, « généralement non filtré par les pare-feux ». Pour la sécurité, c’est l’inverse : un pare-feu classique laisse passer tout le trafic Web (voir le pare-feu), et ne voit pas la différence entre une requête légitime et une requête malveillante adressée à une API. La protection doit donc être assurée par l’API elle-même, complétée par une passerelle et, au besoin, par un pare-feu applicatif qui analyse le contenu des requêtes. Une API est aussi, par nature, faite pour être appelée par des programmes : un attaquant peut l’interroger des millions de fois, sans se lasser, pour aspirer des données ou essayer des combinaisons.

C.2Vérifier les droits sur chaque objet

L’OWASP (Open Worldwide Application Security Project, une fondation qui publie des références sur la sécurité des applications) classe en tête des risques des API le défaut de contrôle d’autorisation au niveau des objets : l’API vérifie que l’appelant est connecté, mais pas qu’il a le droit d’accéder à l’objet précis qu’il demande (exercice 6). Il suffit alors de changer un numéro dans l’adresse pour lire les données des autres. En 2022, l’opérateur australien Optus s’est ainsi vu dérober les données personnelles de près de dix millions de clients, actuels et anciens, par une API mal configurée accessible sans aucune authentification. Les mêmes vérifications s’imposent pour les fonctions : une API d’administration ne doit pas être appelable par un simple utilisateur.

C.3Clés et jetons

Une clé d’API est une longue chaîne secrète qui identifie une application cliente ; elle doit être traitée comme un mot de passe. Elle n’a rien à faire dans le code d’une application mobile ou d’une page Web, que n’importe qui peut examiner : une clé qui donne accès à un service payant ou à des données y serait trouvée en quelques minutes. Pour agir au nom d’un utilisateur, on utilise plutôt des jetons de courte durée, délivrés après authentification selon le protocole OAuth 2.0, un standard qui permet à un utilisateur d’autoriser une application à accéder à certaines de ses données sans lui confier son mot de passe (voir les protocoles d’authentification). Chaque jeton ne doit donner que les droits nécessaires, et les échanges doivent être chiffrés par HTTPS, la version sécurisée de HTTP (voir TLS).

C.4Trop de données, trop d’appels, trop d’API

  • L’exposition excessive : une API qui renvoie l’objet complet de la base de données, en comptant sur l’application pour n’afficher que le nécessaire, livre en réalité tous les champs, y compris confidentiels, à quiconque regarde les réponses. Le serveur ne doit renvoyer que les champs prévus pour l’appelant.
  • L’absence de limite : sans quotas, un attaquant peut aspirer une base entière, essayer des milliers de mots de passe ou saturer le service (voir le déni de service). Chaque API doit limiter le nombre d’appels, la taille des requêtes et des réponses.
  • Les API oubliées : anciennes versions jamais retirées, API de test restées en ligne, API créées par une équipe sans prévenir les responsables de la sécurité. Ces API « fantômes » ou « zombies », que personne ne surveille, sont des cibles de choix. D’où la nécessité d’un inventaire à jour de toutes les API exposées.
  • Les injections : les données reçues par une API doivent être validées comme toute saisie d’un formulaire (voir l’injection SQL et les attaques des applications Web). Les services SOAP, fondés sur XML, ont leurs faiblesses propres, comme l’inclusion d’entités externes, qui permet de faire lire au serveur ses propres fichiers si l’analyseur XML est mal configuré.

C.5Idée reçue

« Notre API n’est utilisée que par notre application mobile ; personne d’autre ne connaît son adresse. » Faux. N’importe quel utilisateur peut observer le trafic de l’application installée sur son propre téléphone, ou en examiner le code, et découvrir toutes les adresses et tous les paramètres de l’API. Toute API accessible depuis Internet doit être considérée comme publique, et sécurisée en conséquence : l’application n’est qu’un client parmi d’autres.

C.6Bonnes pratiques

Concevoir une API

  • Vérifier, à chaque requête et côté serveur, l’identité de l’appelant et ses droits sur l’objet demandé.
  • Ne renvoyer que les champs nécessaires ; valider toutes les entrées ; limiter le nombre et la taille des appels.
  • Journaliser les appels et surveiller les comportements anormaux, comme le parcours de numéros successifs.

Organisation

  • Tenir l’inventaire de toutes les API exposées, retirer les versions obsolètes et les API de test.
  • Placer les API derrière une passerelle qui centralise authentification, quotas et journalisation.
  • Ne jamais placer de clé secrète dans une application mobile ou une page Web ; privilégier des jetons de courte durée aux droits limités.

Référentiels : OWASP, API Security Top 10 (2023) · NIST (National Institute of Standards and Technology, l’institut américain de normalisation) SP 800-228, Guidelines for API Protection for Cloud-Native Systems (2025) · IETF (Internet Engineering Task Force, l’organisme qui normalise les protocoles d’Internet) RFC 9700, Best Current Practice for OAuth 2.0 Security (2025).

Références

  1. R. T. Fielding, Architectural Styles and the Design of Network-based Software Architectures, thèse de doctorat, université de Californie à Irvine, 2000.
  2. W3C, SOAP Version 1.2, recommandation, 2003, 2e éd. 2007 ; Web Services Description Language (WSDL) Version 2.0, 2007.
  3. OASIS, UDDI Version 3.0.2, 2004.
  4. IETF, RFC 9110, HTTP Semantics, 2022 ; RFC 8259, The JavaScript Object Notation (JSON) Data Interchange Format, 2017 ; RFC 6749, The OAuth 2.0 Authorization Framework, 2012.
  5. OpenAPI Initiative, OpenAPI Specification, version 3.1, 2021.
  6. T. Erl, Service-Oriented Architecture: Concepts, Technology, and Design, Prentice Hall, 2005.
  7. J. Lewis, M. Fowler, « Microservices », martinfowler.com, 2014.

Voir aussi

Citer cet article

« Les API et les services web », Encyclopédie informatique, révision du 23 octobre 2026.