Aller au contenu
uencoder

GraphQL Query

Une requête GraphQL utilise la syntaxe { field(args) { subfield } } pour sélectionner exactement les champs de données nécessaires, évitant la sur-récupération et la sous-récupération.

Objectif

Laisser le client déclarer les champs et relations imbriquées dont il a besoin et faire renvoyer au serveur exactement ces données, éliminant la sur-récupération de REST.

Mécanisme

Une requête contient un ensemble de sélection de champs ; chaque champ peut prendre des arguments, des alias, des directives (@skip/@include) et des sous-sélections imbriquées. Les variables $var la paramètrent. Le serveur valide par rapport au schéma, exécute les résolveurs et renvoie les données.

Cas d’usage

  • Récupération précise de données via API
  • Requêtes déclaratives du front-end
  • Récupération à la demande sur mobile

Outils associés

References