GraphQL : langage de requête pour API
Réponse courte
GraphQL est un langage de requête pour API et un runtime qui exécute les requêtes selon un schéma typé. Le client choisit les champs à recevoir, ce qui évite de récupérer des données inutiles. Les requêtes, mutations et abonnements couvrent la lecture, la modification et, lorsqu'ils sont implémentés, le temps réel.
L’essentiel
- Le client demande uniquement les champs dont il a besoin.
- Un schéma typé décrit les types et opérations disponibles.
- Les requêtes, mutations et abonnements couvrent lecture, écriture et temps réel.
- Les fragments regroupent les besoins de données près des composants.
- Les erreurs peuvent renvoyer des données partielles et des détails d'erreur.
Comment fonctionne GraphQL
GraphQL est un langage de requête pour API et un runtime qui exécute les requêtes selon un schéma typé. Il s'adresse aux ingénieurs front-end : les requêtes épousent la structure des vues et la manière dont les données sont consommées. Un service publie les capacités que les clients peuvent consommer, et le client choisit les champs à recevoir au niveau du champ.
Le développement produit passe souvent par la création et la manipulation de hiérarchies de vues. Les requêtes GraphQL épousent ces structures, ce qui rend naturelle la demande de données dont la forme correspond à la réponse. Contrairement à des points d'accès fixes, le client contrôle les données reçues et demande uniquement ce dont il a besoin.
Un serveur GraphQL peut agréger des données provenant de sources distinctes et les présenter sous forme de graphe unifié. Le langage ne dépend d'aucun moteur de stockage particulier. Dans une API REST, obtenir un article et son auteur peut demander plusieurs appels si les points d'accès sont séparés ; avec GraphQL, le schéma peut exposer la relation et récupérer les deux en une seule requête.
Les API GraphQL peuvent exposer leur propre schéma, ce qui permet aux outils et aux bibliothèques clientes de découvrir les types et capacités disponibles. Cela en fait une base solide pour créer des outils partagés et des bibliothèques clientes.
Les fragments permettent de placer les besoins de données de chaque composant près de lui, puis de les résoudre en une seule requête.
Schéma, types et opérations
Le schéma définit les types, champs, relations et opérations disponibles avec le langage de définition de schéma (SDL). La racine Query est obligatoire ; Mutation et Subscription sont facultatives. Les types comprennent les scalaires, les objets, les énumérations, les interfaces, les unions et les objets d'entrée.
Le symbole ! signifie qu'un champ ne peut pas valoir null. Si une erreur survient pendant l'exécution, la réponse peut contenir à la fois des données partielles et des détails d'erreur, selon l'erreur et la possibilité de nullité du schéma.
Le typage fort du schéma permet aux outils et aux bibliothèques clientes de découvrir les types et capacités disponibles. Cela rapproche GraphQL des questions de typage statique vs dynamique, sans imposer un langage particulier.
| Opération | Rôle |
|---|---|
| Query | Récupérer des données |
| Mutation | Créer, mettre à jour ou supprimer des données |
| Subscription | Recevoir des mises à jour en temps réel lorsqu'elles sont implémentées |
Requêtes, mutations et fragments
Une requête demande des champs précis, y compris des données liées exposées par le schéma. Par exemple, une requête peut demander un article avec son identifiant, son titre, son contenu et le nom et l'e-mail de l'auteur ; la réponse suit la structure demandée. Un exemple de réponse contient l'article et l'objet auteur avec les champs demandés.
Les mutations modifient des données, par exemple créer, mettre à jour ou supprimer un enregistrement. Leur comportement dépend de la mise en œuvre du serveur. Un schéma peut définir createBook, updateBook et deleteBook avec des arguments typés et des valeurs de retour.
Les fragments regroupent les besoins de données près des composants et les satisfont avec une seule requête. L'exécution parcourt le graphe de champs selon des règles déterministes, comme un algorithme de résolution.
Les requêtes peuvent utiliser des variables pour réutiliser la même structure avec des valeurs différentes. Cette pratique évite de réécrire la requête.
Conception et gouvernance
Passer d'une logique de points d'accès à une pensée en graphe aide à aligner le schéma avec la logique métier et les systèmes existants. Servir GraphQL sur HTTP comporte des choix de méthode, d'en-têtes, de codes de statut et de conception du point d'accès.
Les téléversements de fichiers peuvent être traités comme des mutations. Pour les erreurs, il faut distinguer les erreurs de premier niveau des erreurs comme données, puis choisir selon qu'il s'agit d'un échec exceptionnel ou attendu.
La gouvernance du schéma comprend des modèles de propriété centralisés, fédérés ou hybrides, ainsi que des revues et des validations automatisées. Ces pratiques aident à garder le schéma cohérent, sûr et facile à faire évoluer à mesure que l'équipe grandit.
Une revue de schéma met en place des processus et des contrôles automatisés pour maintenir la cohérence et la sécurité.
Autres questions fréquentes
Qu'est-ce que GraphQL ?
GraphQL est un langage de requête pour API et un runtime qui exécute les requêtes selon un schéma typé. Le client choisit les champs à recevoir.
Quelle différence avec REST ?
REST expose souvent des points d'accès fixes, tandis que GraphQL laisse le client demander les champs nécessaires et récupérer des données liées en une seule requête.
Qu'est-ce qu'une mutation ?
Une mutation est une opération qui modifie des données, comme créer, mettre à jour ou supprimer un enregistrement. Son comportement dépend de l'implémentation du serveur.
Comment gérer les erreurs ?
La réponse peut contenir des données partielles et des détails d'erreur. Le choix entre erreurs de premier niveau et erreurs comme données dépend du type d'échec.
À quoi servent les fragments ?
Ils définissent les besoins de données d'un composant à proximité de celui-ci et permettent de les satisfaire avec une seule requête.
Pages liées
- Rendu côté client vs côté serveur : différences clés
Le rendu côté client génère le HTML dans le navigateur avec JavaScript, tandis que le rendu côté serveur l'envoie déjà complet. Le premier favorise l'interactivité, le second l'affichage initial et le référencement. Le bon choix dépend du contenu, du trafic et des contraintes serveur.
- CORS c'est quoi : rôle, fonctionnement et sécurité
Le partage de ressources entre origines multiples (CORS) est un mécanisme de sécurité exécuté par les navigateurs web pour autoriser ou bloquer les requêtes réseau adressées à un domaine distinct. Il s'appuie sur des en-têtes HTTP dédiés afin de permettre à un serveur d'indiquer explicitement quelles origines ont le droit d'accéder à ses données.
- Cookies web : fonctionnement et gestion des données
Les cookies web constituent des fichiers de données émis par un serveur web et stockés par le navigateur pour préserver l'état d'une connexion. Ils permettent de reconnaître un utilisateur d'une page à l'autre et de mémoriser ses préférences de navigation, compensant ainsi la nature sans état du protocole HTTP.
- Cache webcam : comprendre le cache web
Le cache web est une copie locale de ressources déjà téléchargées. Il accélère l'affichage des pages et réduit les transferts réseau. Le vider corrige surtout des fichiers obsolètes ou corrompus, pas les mots de passe.
- WebSocket what is it : guide pratique
WebSocket est un protocole qui garde une connexion persistante et bidirectionnelle entre client et serveur. Il convient aux applications temps réel qui échangent souvent des données. Il ne remplace pas HTTP pour les pages et les API classiques.
- Qu'est-ce qu'une API REST ? Guide clair
Une API sert de pont entre programmes pour échanger des données. Une API REST applique les règles REST aux échanges HTTP, généralement autour de ressources et de JSON. Toute API REST appartient à la famille des API, sans que toute API soit REST.
Comment cette page a été préparée
Avant la rédaction, le sujet a été étudié dans les sources ci-dessous. La page a ensuite passé des contrôles de qualité automatiques.