Les quatre styles d’API entre lesquels se décide une architecture API ne reposent pas sur des textes de même nature. REST est un style d’architecture décrit en 2000 dans une thèse de doctorat. GraphQL est une spécification publiée par éditions successives. gRPC est un cadre logiciel open source, que décrit sa documentation. Les API pilotées par événements peuvent se décrire avec une spécification, AsyncAPI, qui ne définit pas le style lui-même.
Nous appelons ici architecture API l’ensemble des choix par lesquels un système d’information expose ses fonctions et ses données à d’autres logiciels : le style de chaque échange, la forme de son contrat, ses règles d’évolution et de sécurité. Aucun des quatre styles ne l’emporte en général : chacun expose un objet différent, laisse au consommateur un travail différent et appelle une gouvernance différente. Une stratégie d’API fixe ensuite, pour tout le système d’information, quels styles sont admis pour quels échanges et quelles règles valent pour tous. Sources consultées le 12 novembre 2026.
Quatre styles, quatre objets exposés
REST est défini au chapitre 5 de la thèse de Roy Fielding, « Architectural Styles and the Design of Network-based Software Architectures » (université de Californie à Irvine, 2000). Le style s’y construit par contraintes successives : client-serveur, sans état, cache, interface uniforme, système en couches, et code à la demande, seule contrainte optionnelle. L’interface uniforme en réunit quatre : identification des ressources, manipulation des ressources par des représentations, messages autodescriptifs, hypermédia comme moteur de l’état de l’application. L’objet exposé est donc une ressource. La thèse précise que REST ne restreint pas la communication à un protocole particulier, et la synthèse du chapitre (section 5.5) attache ses propriétés à ces contraintes « appliquées comme un tout » (« when applied as a whole »).
La spécification GraphQL, dans son édition de septembre 2026, se présente comme un langage de requête et un moteur d’exécution (notre traduction). Un service publie un schéma typé et admet trois opérations : la requête (lecture), la mutation (écriture suivie d’une lecture) et l’abonnement, requête de longue durée qui reçoit des données au fil d’événements. Selon la page de la fondation GraphQL, le langage a été créé en 2012 et ouvert par Facebook en 2015 ; la fondation, créée en 2019, est hébergée par la Linux Foundation.
gRPC, selon sa documentation, permet à un client d’appeler une méthode d’un serveur distant « comme s’il s’agissait d’un objet local » (notre traduction). Le service se définit par ses méthodes, leurs paramètres et leurs types de retour, par défaut en Protocol Buffers. La documentation distingue quatre sortes de méthodes : appel simple, flux du serveur, flux du client, flux dans les deux sens. Né chez Google selon son site, le projet a été accepté par la CNCF le 16 février 2017 au niveau de maturité « Incubating », selon la fiche de la CNCF.
AsyncAPI, version 3.1.0, décrit des API pilotées par messages (« message-driven APIs ») dans un format lisible par machine, quel que soit le protocole (AMQP, MQTT, WebSockets, Kafka, entre autres). L’objet exposé est un message, publié sur un canal par une application émettrice et reçu par des applications réceptrices. Notre fiche sur l’architecture event-driven présente les modèles d’échange.
Le travail laissé au consommateur
En REST, le client suit l’interface uniforme et porte l’état de la session : chaque requête doit contenir toute l’information nécessaire à sa compréhension (section 5.1.3, notre traduction). La thèse nomme la contrepartie de l’interface uniforme : elle dégrade l’efficacité, l’information circulant sous une forme standardisée plutôt que propre aux besoins d’une application (section 5.1.5, notre traduction).
En GraphQL, le client écrit sa requête champ par champ, et la réponse contient, selon la spécification, exactement ce qu’il a demandé, sans plus. Il découvre le schéma par introspection, et sa requête se valide contre le système de types avant exécution. Selon notre lecture, la charge se déplace : le producteur ne connaît plus d’avance la forme des requêtes.
En gRPC, le client dispose d’un « stub » qui expose les mêmes méthodes que le serveur. Il le génère dans son langage à partir du fichier .proto partagé avec le producteur. Pour les flux, la documentation garantit l’ordre des messages au sein d’un même appel.
Avec des événements, le consommateur s’abonne à un canal et traite des messages dont l’émetteur n’a pas à connaître les destinataires. AsyncAPI ne présume d’aucune topologie : les garanties d’ordre et de remise dépendent, selon notre lecture, du protocole et du serveur choisis.
Contrats, gouvernance et limites côte à côte
| REST | GraphQL | gRPC | Événements | |
|---|---|---|---|---|
| Objet exposé | Ressources et leurs représentations | Schéma typé, interrogé par requêtes | Méthodes de service | Messages publiés sur des canaux |
| Description du contrat | OpenAPI pour une API HTTP ; la thèse n’impose aucun format | Le schéma, lisible par introspection | Fichier .proto | AsyncAPI |
| Évolution prévue par la source | Évolution indépendante des composants (thèse, 5.1.5) | Directive @deprecated sur un champ | Non relevée dans les pages lues | Champ obligatoire de version de l’API (info.version) |
| Gouvernance que nous proposons | Propriétaire par ressource, description publiée | Propriétaire du schéma, revue des ajouts et des retraits | Dépôt partagé des fichiers .proto, règles de compatibilité | Catalogue des canaux, propriétaire par message |
| Limite | Interface non optimale hors transfert hypermédia (thèse) | Coût des requêtes à maîtriser par le producteur (notre lecture) | Code généré des deux côtés (notre lecture) | Consommateurs mis à jour avec un délai (notre lecture) |
La spécification OpenAPI, version 3.2.1 du 10 septembre 2026, définit une description d’interface standard et indépendante du langage de programmation pour les API HTTP. Le tableau ne compare aucune performance, qui dépend des charges et des implémentations et se mesure sur le cas de l’organisation.
Une place pour chaque style
À notre lecture, REST convient lorsque les consommateurs sont nombreux, parfois inconnus, et que des intermédiaires doivent s’interposer : selon la thèse, la contrainte de système en couches permet d’introduire des intermédiaires (« proxies, gateways, and firewalls », soit mandataires, passerelles et pare-feu). Une passerelle d’API est l’un d’eux.
GraphQL convient aux écrans dont les besoins varient : sa spécification se dit guidée par les besoins des vues et des développeurs qui les écrivent (« product-centric »).
gRPC convient aux appels entre services dont les équipes partagent un fichier de contrat et des langages pris en charge, notamment pour des flux dans les deux sens.
Les événements conviennent lorsque l’émetteur peut publier sans attendre ses destinataires. Notre page architecture SI compare ce mode d’intégration aux appels synchrones et aux échanges de fichiers.
Un même domaine peut exposer deux styles, chacun pour ses consommateurs. Le choix et ses motifs se consignent dans un enregistrement de décision d’architecture (ADR).
Une stratégie d’API à l’échelle du système d’information
La stratégie d’API, ou stratégie API, rend ces choix cohérents d’un projet à l’autre. Nous proposons qu’elle fixe cinq règles.
- Les styles admis, et pour chacun les échanges auxquels il convient, à partir de critères comme ceux du tableau.
- Un format de contrat par style (OpenAPI, AsyncAPI, schéma GraphQL, fichier .proto) et le lieu où les contrats se publient. L’inventaire, le portail et les versions relèvent de l’API management.
- Un propriétaire nommé pour chaque API et chaque canal.
- Des règles de sécurité communes : exposition par une passerelle pour les consommateurs externes, authentification des services entre eux, par exemple par TLS mutuel.
- Une procédure de dérogation, instruite par une ADR et réexaminée à échéance.
Elle s’adosse aux règles d’intégration et à l’instance d’architecture de notre page de service, et se relit lorsqu’une ADR demande un style que la règle n’admet pas : la dérogation indique si la règle correspond encore aux échanges du système d’information.