GraphQL : définition simple
Le GraphQL est un langage de requête pour les API : le logiciel qui demande des données précise lui-même, champ par champ, ce dont il a besoin. Le serveur renvoie exactement cela, ni plus ni moins, en une seule demande.

À retenir
- GraphQL ne remplace pas l’API : c’est une manière de la construire, qui laisse le client choisir les données qu’il reçoit.
- Il devient utile quand plusieurs écrans (site, application mobile, tableau de bord) réclament chacun des informations différentes.
- Pour un site vitrine ou un besoin simple, une API classique suffit et se met en place plus vite.
GraphQL en trois temps
Une API classique ressemble à un menu fixe : vous commandez « la fiche produit » et vous recevez tout le plateau, même ce que vous ne mangerez pas.
GraphQL fonctionne à la carte : vous listez les plats voulus, et la cuisine ne prépare que cela. Voici la scène pour l’application mobile d’une boutique.
Une fiche produit, étape par étape
- La question. L’application envoie une seule demande : « pour le produit 42, donne-moi le nom, le prix, la première photo et le stock disponible ».
- Les champs sont listés un par un
- Une seule demande pour tout l’écran
- Le client décide, pas le serveur
- Le schéma. Le serveur possède un schéma : la liste des types de données qu’il connaît (produit, catégorie, avis) et des liens entre eux. Il vérifie que la question est valide avant d’y répondre.
- Un catalogue précis des données
- Les liens entre elles sont déclarés
- Une question invalide est refusée
- La réponse. Le serveur renvoie un petit document au format JSON, construit sur le modèle de la question. Rien ne manque, rien ne dépasse.
- Même forme que la question
- Pas de données inutiles
- Écran affiché plus vite
GraphQL au quotidien
On rencontre GraphQL dans des projets où plusieurs écrans partagent les mêmes données.
Voici six situations d’entreprise et ce qu’il y change.
| Situation | Ce que fait GraphQL | Ce que vous y gagnez |
|---|---|---|
| Application mobile de boutique | La liste des produits ne demande que le nom, le prix et une vignette, pas la description complète. | Des écrans plus rapides et moins de données mobiles consommées. |
| Site et application sur le même serveur | Chaque écran réclame ses propres champs auprès d’un seul point d’entrée. | Un seul back-end à maintenir au lieu d’un par support. |
| Tableau de bord de PME | En une demande, il récupère le chiffre d’affaires du mois, les commandes en attente et les derniers clients. | Un tableau de bord qui s’affiche d’un coup, sans dix appels successifs. |
| Site WordPress « headless » | Le site public lit ses contenus dans WordPress par GraphQL (par exemple avec l’extension WPGraphQL). | Une équipe éditoriale qui garde WordPress et un site public plus libre dans son design. |
| Boutique Shopify sur mesure | La vitrine personnalisée interroge l’API Storefront de Shopify, qui s’exprime en GraphQL. | Une vitrine unique, branchée sur le catalogue et le panier de Shopify. |
| Évolution d’un écran | On ajoute un champ côté serveur ; les anciennes versions de l’application continuent à ne demander que les leurs. | Des mises à jour sans casser les applications déjà installées. |
Le vocabulaire GraphQL
Quelques mots reviennent dans toutes les réunions.
Les connaître suffit pour comprendre un devis ou un cahier des charges qui parle de GraphQL.
Query (requête)
La demande de lecture : on décrit les champs voulus et on reçoit les valeurs correspondantes. C’est l’équivalent d’une consultation.
- Lecture seule
- Champs choisis par le client
- Réponse sur le même modèle
Mutation
La demande d’écriture : créer un compte, passer une commande, modifier une adresse. Elle renvoie aussi les champs que vous souhaitez voir confirmés.
- Création, modification, suppression
- Contrôle des droits côté serveur
- Confirmation immédiate
Subscription (abonnement)
Le client reste branché et reçoit un message dès qu’une donnée change : nouveau message dans un chat, suivi de livraison en direct.
- Données en temps réel
- Notifications dans l’application
- Plus technique à héberger
Schéma
Le contrat du serveur : la liste de tout ce qu’on peut demander, avec le type de chaque donnée. Il sert aussi de documentation à l’équipe.
- Types de données déclarés
- Documentation générée
- Erreurs repérées tôt
Resolver
Le petit morceau de code qui va chercher une donnée précise (en base, dans un autre service) quand un champ est demandé. C’est le travail du développeur.
- Un resolver par champ
- Peut interroger plusieurs sources
- À soigner pour la performance
3 signes qu’il peut servir
La plupart des petits projets n’en ont pas besoin.
Ces trois situations indiquent en revanche que GraphQL mérite d’être étudié pendant le cadrage.
Plusieurs écrans, plusieurs besoins
Votre site, votre application mobile et votre espace client affichent les mêmes objets (produits, clients, commandes) mais pas les mêmes champs.
- Un même client vu de trois façons
- Réponses d’API trop chargées
- Endpoints à multiplier
Des données qui pèsent trop
Vos utilisateurs sont souvent sur mobile, avec une connexion moyenne, et l’application télécharge des informations qu’elle n’affiche pas.
- Écrans lents en 4G
- Données mobiles gaspillées
- Batterie sollicitée pour rien
Trop d’allers-retours
Pour afficher un seul écran, l’application enchaîne cinq ou six appels à l’API, l’un après l’autre, chacun dépendant du précédent.
- Chargement en cascade
- Code côté application complexe
- Plusieurs points de panne
Questions fréquentes
Que veut dire GraphQL ?
GraphQL signifie « Graph Query Language », un langage de requête pour les données. Il a été créé chez Facebook, utilisé en interne dès 2012, puis publié en open source en 2015. Il est aujourd’hui maintenu par la GraphQL Foundation, qui dépend de la Linux Foundation.
GraphQL remplace-t-il une API REST ?
Non, les deux coexistent. Une API REST expose une adresse par type d’information et renvoie la fiche entière. GraphQL expose un point d’entrée unique et laisse le client choisir les champs. Pour un besoin simple, REST reste plus facile à mettre en place, à mettre en cache et à comprendre.
GraphQL est-il plus rapide ?
Pas automatiquement. Il réduit la quantité de données transportées et le nombre d’appels, ce qui aide surtout sur mobile. En revanche, une demande très imbriquée peut être lourde à calculer côté serveur, et la mise en cache est moins directe qu’avec REST. Le gain dépend de la conception.
GraphQL est-il sécurisé ?
Il demande les mêmes précautions que toute API : authentification, droits vérifiés à chaque champ sensible, échanges chiffrés. S’y ajoute un point propre à GraphQL : limiter la profondeur et le coût des requêtes pour qu’un utilisateur malveillant ne puisse pas saturer le serveur. Ces garde-fous se prévoient dès la conception.
Mon site WordPress ou ma boutique Shopify peuvent-ils s’en servir ?
Oui. WordPress dispose d’extensions comme WPGraphQL, et Shopify propose des API Storefront et Admin en GraphQL. C’est souvent le cas dans un site « headless », où le contenu reste dans l’outil que vos équipes connaissent et où le site public est construit à part.
Une petite entreprise a-t-elle besoin de GraphQL ?
Rarement. Un site vitrine ou une boutique classique n’en profitent pas. Il se justifie quand plusieurs interfaces partagent les mêmes données, par exemple un site et une application mobile. C’est l’une des questions traitées au cadrage d’un logiciel sur mesure, avec un devis détaillé sous 24 h après un appel de 30 minutes.
À lire aussi
Un projet avec GraphQL ?
Choisir GraphQL ou une API classique se décide pendant le cadrage, selon vos écrans et vos données. Voici les prestations où la question se pose.

Logiciel sur mesure
Un back-end qui sert plusieurs interfaces, avec l’API adaptée à vos usages.
- Cadrage de vos données
- API choisie selon l’usage
- Code source livré

Application mobile
Une application économe en données, branchée sur le même serveur que votre site.
- Écrans rapides
- Données partagées avec le site
- Maquettes validées avant le code

Web app et PWA
Une application web qui interroge précisément vos données et reste fluide.
- Interface réactive
- Installable sur mobile
- Accès sécurisés

Logiciel SaaS
Une API claire dès le départ, pour accueillir vos clients puis vos partenaires.
- Architecture pensée pour évoluer
- Comptes et droits par client
- Devis détaillé sous 24 h




Skyward Resto

