Description
Lire un schéma GraphQL, construire des requêtes utiles et interpréter correctement les réponses.
Objectifs pédagogiques
- Comprendre le rôle de GraphQL dans l’exposition et la consommation d’API
- Lire un schéma GraphQL pour identifier les types, champs et arguments disponibles
- Construire une requête GraphQL simple puis imbriquée
- Utiliser des arguments, variables, aliases et fragments
- Comprendre la structure d’une mutation
- Lire une réponse JSON et analyser les erreurs les plus fréquentes
- Produire une requête GraphQL adaptée à un besoin métier
Public concerné
Développeurs web, frontend et backend
Testeurs techniques et intégrateurs
Chefs de projet techniques
Business analysts techniques
Toute personne amenée à lire ou tester des requêtes GraphQL
Prérequis
Connaître les principes généraux d’une API et des échanges client / serveur
Être à l’aise avec les structures de données de type objet et JSON
Avoir une première expérience de lecture de requêtes HTTP ou d’utilisation d’API est recommandé
Avoir des bases en développement web ou en environnement applicatif technique
Déroulé du programme
1
JOUR 1- Séquence 1 – Comprendre GraphQL et son fonctionnement (1h15)
1h
- Définition de GraphQL et positionnement par rapport aux API REST
- Présentation des opérations Query, Mutation et Subscription
- Compréhension du rôle central du schéma dans l’accès aux données
- TP : analyser un exemple d’appel REST et son équivalent GraphQL pour identifier les différences de logique et de structure
2
JOUR 1- Séquence 2 – Lire un schéma GraphQL (2h00)
2h
- Lecture des types, champs, scalaires, listes et champs obligatoires
- Compréhension du type Query et des entrées disponibles
- Repérage des arguments attendus sur les champs
- TP : lire un schéma simplifié et retrouver les champs à utiliser pour répondre à plusieurs besoins métiers
3
JOUR 1- Séquence 3 – Construire une requête simple et imbriquée (1h45)
1h
- Structure d’une requête GraphQL
- Sélection de champs et sous-champs
- Lecture de la réponse JSON associée
- TP : écrire une requête permettant de récupérer un objet principal et ses données liées, puis interpréter la réponse obtenue
4
JOUR 1- Séquence 4 – Utiliser les arguments et les variables (2h00)
2h
- Passage d’arguments dans une requête
- Utilisation de variables pour rendre une requête réutilisable
- Paramétrage d’une requête selon différents cas d’usage
- TP : transformer une requête statique en requête paramétrée avec variables pour filtrer ou cibler un enregistrement
5
JOUR 2- Séquence 5 – Structurer une requête avec aliases et fragments (2h00)
2h
- Utilisation des aliases pour distinguer plusieurs appels similaires
- Utilisation des fragments pour factoriser des sélections de champs
- Amélioration de la lisibilité et de la maintenabilité
- TP : réécrire une requête redondante avec aliases et fragments afin de la rendre plus claire et plus réutilisable
6
JOUR 2- Séquence 6 – Comprendre les erreurs et valider une requête (1h45)
1h
- Différence entre erreur de syntaxe, erreur de validation et erreur d’exécution
- Lecture des messages d’erreur les plus fréquents
- Analyse d’une réponse contenant data et errors
- TP : corriger une série de requêtes erronées à partir des messages de validation et du schéma fourni
7
JOUR 2- Séquence 7 – Lire et comprendre une mutation (1h15)
1h
- Structure d’une mutation GraphQL
- Passage des données en entrée
- Choix des champs retournés après exécution
- TP : exécuter une mutation simple puis analyser les données retournées pour vérifier le résultat obtenu
8
JOUR 2- Séquence 8 – Atelier de consolidation (2h00)
2h
- Analyse d’un besoin métier
- Lecture du schéma
- Choix du point d’entrée adapté
- Construction de la requête
- Interprétation du résultat
- TP : construire une requête complète à partir d’un besoin fonctionnel, puis expliquer sa structure et la réponse retournée
Informations
Durée
2 jour(s)
14h
Tarif
Sur demande
