Aller au contenu
Cabinet d'expertise en transformation technologique · ARDIANE Group Innover, sécuriser, réussir

Ingénierie

REST, GraphQL, gRPC ou événements : comparer les styles pour bâtir une architecture API

L'essentiel

L'architecture API désigne ici les choix par lesquels un système d'information expose ses fonctions et ses données à d'autres logiciels : style de chaque interface, forme du contrat, règles d'évolution et de sécurité. Management Square compare REST, GraphQL, gRPC et les API pilotées par événements, puis décrit ce qu'une stratégie d'API fixe à l'échelle du système d'information.

Sommaire de la page

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.

Insights

À lire sur le sujet

Tous les insights
Mettre en œuvre le spec driven development avec un assistant de code, et savoir quoi relire

Le spec driven development, ou développement piloté par les spécifications, consiste à faire rédiger puis relire une spécification, un plan technique et une liste de tâches avant qu'un assistant de code n'écrive le code. Management Square décrit ici les étapes de cette méthode dans l'ordre, avec le livrable de chacune et la relecture qu'il appelle, d'après des sources publiques lues le 12 novembre 2026.

Lire l'analyse
Bâtir puis réviser un tech radar d'entreprise qui éclaire les choix d'architecture

Un tech radar, ou radar technologique, place les technologies qu'une organisation emploie ou examine dans des quadrants et des anneaux qui disent la confiance qu'elle leur accorde. Management Square propose une méthode pour en construire un et le tenir à jour : périmètre et quadrants, sens des anneaux, propositions et décisions, publication, révision, et ce qu'il change dans les décisions d'architecture.

Lire l'analyse
Dresser une feuille de route de modernisation des applications pour un parc entier

Une feuille de route de modernisation des applications attribue à chaque application d'un parc une voie de traitement, un rang et un point de décision, puis range ces lignes selon les dépendances et la capacité disponible. Management Square propose ici une méthode en six temps pour l'établir, du relevé du parc à la règle de révision, et indique le résultat tangible de chaque temps.

Lire l'analyse

FAQ

Questions fréquentes

Une autre question ? Posez-la-nous

Faut-il préférer GraphQL à REST pour une nouvelle API ?

Aucun des deux ne l'emporte en général. La spécification GraphQL laisse au client le choix exact des champs qu'il reçoit, ce qui sert des écrans aux besoins variés, mais, selon notre lecture, le producteur ne connaît plus d'avance la forme des requêtes. REST, tel que le décrit la thèse de Roy Fielding, impose une interface uniforme qui facilite les intermédiaires comme les caches, au prix d'une forme standardisée des échanges. Chaque échange se tranche selon les consommateurs visés.

Qu'est-ce qu'une stratégie API ?

Une stratégie d'API est l'ensemble des règles qu'une organisation applique à toutes ses interfaces de programmation : les styles admis et les échanges auxquels chacun convient, le format de description du contrat, la publication et le propriétaire de chaque API, la politique de versions, les règles de sécurité et la procédure de dérogation. Elle se distingue de l'outillage d'API management, qui l'applique sans en tenir lieu.

Quel format utiliser pour décrire le contrat d'une API ?

Le format dépend du style. La spécification OpenAPI décrit les API HTTP, la spécification AsyncAPI les API pilotées par messages, quel que soit le protocole. Une API GraphQL se décrit par son schéma, que le langage permet d'interroger par introspection, et un service gRPC par un fichier .proto écrit, par défaut, en Protocol Buffers. Les versions de ces spécifications évoluent et se vérifient à la date du projet.

Un projet à faire aboutir ?

Un premier échange suffit pour situer votre enjeu, identifier les bons interlocuteurs et vous dire franchement ce que nous pouvons apporter.