GraphQL vs. API REST

Avez-vous déjà travaillé sur un projet de développement d'application web ? Si oui, alors vous avez peut-être déjà rencontré le terme "GraphQL". Mais que signifie-t-il exactement ? Est-il utilisé dans les configurations côté serveur ou côté client ? De plus, quand l'intégration de GraphQL est-elle préférable à d'autres alternatives ? Dans cet article, nous vous guiderons à travers ces questions.

En tant que canal de communication pour le transfert de données entre les composants logiciels sur internet, les API jouent un rôle indispensable dans les architectures de services web modernes, agissant comme de l'oxygène. Les technologies d'API telles que SOAP (un protocole de messagerie pour les services web), REST (style architectural) et GraphQL (un langage de requête et outil) facilitent le développement logiciel en soutenant l'intégration et l'échange de données entre différents services, rendant le développement plus pratique et flexible.

Malgré les nombreux types d'API, les débats de ces dernières années se sont principalement concentrés sur deux paradigmes principaux : REST (transfert d'état représentationnel) et GraphQL. Les deux offrent une gamme d'avantages et sont utilisés mondialement dans des projets web. Cependant, ils diffèrent sensiblement dans la gestion de la communication des données.

Qu'est-ce que l'API REST ?#

REST est un style architectural structuré développé au début du XXIe siècle pour construire des applications hypermédia inter-réseaux, conçu pour adopter un protocole de communication sans état et cacheable entre clients et serveurs. L'API REST (également connue sous le nom d'API RESTful) est le moteur de l'architecture REST.

L'API REST utilise les URI (Identificateurs de Ressource Uniforme) pour adresser les ressources. Elle fonctionne en utilisant différents points de terminaison pour effectuer des opérations CRUD (create, read, update, et delete) sur les ressources réseau. Elle repose sur des formats de données prédéfinis (connu sous le nom de types de média ou types MIME) pour déterminer la forme et la taille des ressources qu'elles fournissent aux clients. Les formats les plus courants sont JSON et XML (parfois HTML ou texte brut).

Après que le client a demandé une ressource, le serveur traite la requête et retourne toutes les données relatives à cette ressource. La réponse contient des codes de réponse HTTP tels que "200 OK" (pour une requête REST réussie) et "404 Not Found" (pour une ressource inexistante).

Comment fonctionne l'API REST ?#

Les API REST reposent sur des points de terminaison prédéfinis qui exposent des ressources sur HTTP. Chaque point de terminaison représente une ressource, telle que des utilisateurs ou des publications, et est identifié par une URL unique. Les opérations REST sont liées aux méthodes HTTP standards comme GET, POST, PUT et DELETE, qui correspondent à la récupération, la création, la mise à jour et la suppression de données.

Par exemple, une requête vers GET /users récupère une liste complète d'utilisateurs, tandis que GET /users/123 obtient les détails d'un utilisateur spécifique identifié par son ID. Si vous avez également besoin d'accéder à des données liées, telles que les organisations de l'utilisateur et les rôles d'organisation, vous devrez effectuer des appels supplémentaires à GET /users/123/organizations.

REST suit une approche centrée sur les ressources, se concentrant sur l'accès et la manipulation de ressources distinctes.

Qu'est-ce que GraphQL ?#

GraphQL est à la fois un type d'API (ou langage de requête) et un moteur d'exécution pour répondre à ces requêtes. Il offre une API simplifiée et est particulièrement adapté aux applications mobiles et à l'implémentation d'architectures complexes nécessitant des sous-ensembles de données spécifiques.

Avec GraphQL, les développeurs peuvent spécifier les données qu'ils souhaitent récupérer de l'API. Il permet également une récupération des données à la demande au lieu de tout récupérer à la fois, applique les modifications immédiatement et intègre des sources de données tierces dans l'application.

Les applications peuvent utiliser des requêtes GraphQL pour appeler des services GraphQL. Ces requêtes retournent les éléments de données exacts demandés par le client. Cela économise de multiples appels API, la bande passante réseau et le post-traitement. C'est une solution extrêmement efficace pour les API centrées sur les données qui sont situées près des dispositifs consommateurs tels que les tablettes et les téléphones mobiles.

Comment fonctionne GraphQL ?#

GraphQL, en revanche, adopte une approche basée sur les requêtes. Au lieu de points de terminaison prédéfinis, GraphQL expose un unique point de terminaison qui accepte des requêtes structurées. Les clients spécifient précisément quelles données ils ont besoin en utilisant un langage de requête.

Par conséquent, une implémentation complète de GraphQL doit avoir deux parties : un schéma et des résolveurs.

Schéma GraphQL#

Les schémas définissent les types de données et leurs champs pouvant être récupérés par les requêtes GraphQL :

Par exemple, supposons que vous ayez le schéma suivant :

Un client peut interroger le nom, l'email, les organisations et les rôles d'un utilisateur en utilisant la requête suivante :

Cette requête non seulement récupère uniquement les champs demandés (email et organisations) mais aussi les données associées (rôles) en une seule requête.

Résolveur GraphQL#

Un résolveur GraphQL est un composant clé dans un serveur GraphQL qui détermine comment récupérer ou calculer les données demandées par un client dans une requête GraphQL. Lorsqu'un client envoie une requête, chaque champ de la requête est associé à un résolveur, qui contient la logique pour récupérer ou calculer les données pour ce champ.

Dans l'exemple ci-dessus, les résolveurs pour le schéma ressembleraient à ceci :

Il existe deux types de résolveurs : les résolveurs racine et les résolveurs de champs.

• Résolveurs racine : Gèrent les champs de niveau supérieur dans le schéma, tels que Query, Mutation et Subscription.
• Résolveurs de champs : Gèrent les champs individuels au sein d'un type, souvent pour des requêtes imbriquées. Si aucun résolveur spécifique n'est fourni pour un champ, GraphQL utilise le résolveur par défaut, qui retourne la valeur de l'objet parent avec le nom de champ correspondant.

Opérations GraphQL#

GraphQL prend en charge trois types d'opérations : queries, mutations et subscriptions.

• Query : Utilisée pour LIRE des données.
• Mutation : Utilisée pour ÉCRIRE des données, incluant des opérations pour ajouter, modifier et supprimer des données.
• Subscription : Utilisée pour demander une connexion persistante pour des données, permettant au client de déclarer les types d'événements qui l'intéressent et les données qui devraient être retournées.

Différences entre GraphQL et les API REST#

GraphQL et les API REST sont des outils pour échanger des données entre différents services web, mais en raison de leurs différentes approches pour résoudre les problèmes, voici les principales différences entre eux :

Récupération de données#

L'API REST sur-récupère ou sous-récupère souvent des données parce que les points de terminaison renvoient des réponses fixes. GraphQL résout ce problème en permettant aux clients de demander exactement ce dont ils ont besoin, réduisant ainsi le transfert de données inutile. Cela rend GraphQL idéal pour les applications avec des besoins de données complexes, telles que des environnements mobiles ou à faible bande passante.

Imaginez l'exemple ci-dessus où vous devez récupérer les données statiques d'un utilisateur, les organisations et les rôles d'organisation assignés à l'utilisateur. Avec l'API REST, vous auriez besoin de faire de multiples requêtes vers différents points de terminaison pour obtenir toutes les données. Cependant, avec GraphQL, vous pouvez récupérer toutes les données en une seule requête.

Flexibilité#

La structure basée sur les points de terminaison de REST est simple et fonctionne bien pour les applications simples avec des opérations CRUD standard. Cela est dû au fait que les API REST sont conçues pour être centrées sur les ressources, chaque point de terminaison représentant une ressource spécifique. La principale limitation de cette approche est qu'elle ne permet pas une itération rapide et des changements dans les exigences des clients. Avec chaque changement apporté au client, le serveur doit être mis à jour pour tenir compte des nouvelles exigences, soit en ajoutant de nouveaux points de terminaison soit en mettant à jour ceux existants. Cela se termine souvent avec beaucoup de points de terminaison redondants et une gestion complexe des versions de l'API.

GraphQL, en revanche, est plus flexible et permet aux clients de demander uniquement les données dont ils ont besoin. Cette flexibilité est particulièrement utile quand les exigences des clients changent fréquemment, car elle élimine le besoin de modifier l'implémentation de l'API côté serveur. Les clients peuvent demander de nouveaux champs ou des données imbriquées sans nécessiter de changements sur le serveur.

Mise en cache#

Bien que GraphQL soit plus efficace et flexible en termes de récupération de données, il présente également certains inconvénients. L'un des principaux problèmes est la mise en cache.

L'API REST possède un écosystème mature. En raison de sa nature sans état et standardisée, il est facile de mettre en cache les réponses tant au niveau du serveur que du client. Cela peut réduire considérablement le nombre de requêtes faites au serveur et améliorer les performances.

Cependant, en raison de sa flexibilité, de nombreuses technologies de mise en cache disponibles pour l'API REST ne sont pas applicables à GraphQL. Il est nécessaire de gérer la mise en cache côté client, en fonction des cas d'utilisation spécifiques, ce qui entraîne une charge de travail supplémentaire pour le développement client.

Avantages et inconvénients#

Conclusion#

Bien que GraphQL ait gagné une forte dynamique en tant que nouveau venu ces dernières années, l'API REST conserve encore une importance significative pendant longtemps en raison de sa conception atomique et de sa rigueur.

REST et GraphQL répondent à des besoins différents et excellent dans des scénarios différents. La simplicité de REST en fait un choix parfait pour les applications simples et les microservices. GraphQL se distingue dans les scénarios nécessitant une récupération de données flexible et efficace, en particulier dans les applications avec des clients divers ou des relations complexes entre les données. Le choix entre les deux dépend des besoins spécifiques de votre projet, de l'expertise de l'équipe, et des besoins de scalabilité à long terme.