Accueil » Glossaire » GraphQL

GraphQL : définition simple

Techniques29 octobre 2026

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

  1. 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
  2. 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
  3. 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.

SituationCe que fait GraphQLCe que vous y gagnez
Application mobile de boutiqueLa 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 serveurChaque é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 PMEEn 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 mesureLa 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 écranOn 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é
Voir la page

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
Voir la page

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
Voir la page

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
Voir la page