Description
Cette formation d'une journée permet à un profil fonctionnel ou support de gagner en autonomie sur la lecture et l'interprétation des requêtes GraphQL. L'objectif n'est pas de développer des requêtes complexes, mais de savoir lire un schéma, comprendre ce qu'une requête demande, interpréter la réponse JSON renvoyée et diagnostiquer les erreurs les plus fréquentes.
Objectifs pédagogiques
- Comprendre le rôle de GraphQL dans l'exposition et la consommation d'une API
- Lire un schéma GraphQL pour identifier les points d'entrée, types, champs, arguments et contraintes utiles
- Lire, compléter et tester une requête simple puis imbriquée
- Identifier le rôle des variables dans une requête GraphQL
- Interpréter une réponse JSON, notamment les sections data et errors
- Diagnostiquer les erreurs fréquentes et qualifier les anomalies pour correction ou escalade
- Reconnaître la structure d'une mutation sans chercher à développer des opérations complexes
Public concerné
Consultants fonctionnels et consultants formateurs progiciel
Techniciens et consultants support client
Testeurs fonctionnels et intégrateurs
Toute personne amenée à lire, tester ou diagnostiquer des requêtes GraphQL sans les développer
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 déjà consulté ou manipulé une API ou un outil de requêtage est un plus
Déroulé du programme
1
Séquence 1 : Comprendre GraphQL et son fonctionnement (1h00)
1h
2
• Définition de GraphQL et positionnement par rapport aux API REST
3
• Présentation des opérations Query, Mutation et Subscription, avec un focus opérationnel sur Query et une reconnaissance des Mutations
4
• Rôle central du schéma dans l'accès aux données
5
• TP : comparer un appel REST et son équivalent GraphQL pour identifier les différences de logique et de structure
6
Séquence 2 : Lire un schéma GraphQL (1h30)
1h
7
• Lecture des types, champs, scalaires et points d'entrée interrogeables
8
• Lecture des listes, champs optionnels, champs non nuls et implications fonctionnelles des valeurs nulles
9
• Compréhension du type Query et repérage des arguments attendus sur les champs
10
• TP : à partir d'un schéma simplifié, retrouver les points d'entrée et les champs à utiliser pour répondre à plusieurs besoins fonctionnels
11
Séquence 3 : Construire et lire une requête simple puis imbriquée (1h45)
1h
12
• Structure d'une requête GraphQL
13
• Sélection de champs et sous-champs
14
• Identifier la requête, les variables associées et leur rôle dans le filtrage ou la sélection des données
15
• Lecture de la réponse JSON associée
16
• TP : lire et compléter une requête récupérant un objet principal et ses données liées, puis interpréter la réponse obtenue
17
Séquence 4 : Comprendre et diagnostiquer les erreurs (1h45)
1h
18
• Différence entre erreur de syntaxe, erreur de validation et erreur d'exécution
19
• Lecture des messages d'erreur les plus fréquents
20
• Analyse d'une réponse contenant data et errors
21
• TP : à partir de requêtes erronées et des messages renvoyés, identifier la cause, corriger les cas simples ou qualifier l'anomalie pour escalade technique
22
Séquence 5 : Reconnaître une mutation et atelier de consolidation (1h00)
1h
23
• Structure d'une mutation GraphQL (en lecture)
24
• Données passées en entrée et champs retournés
25
• Atelier : à partir d'un besoin fonctionnel proche du quotidien du participant, lire le schéma, choisir le point d'entrée, lire la requête correspondante et interpréter le résultat
Informations
Durée
7 jour(s)
7h
Tarif
Sur demande
