---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Tester les API GraphQL avec l'explorateur GraphQL

# Tester les API GraphQL avec l'explorateur GraphQL {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Testez vos API GraphQL à l'aide d'un outil de test GraphQL intégré.

## Avant de commencer

Créez un schéma pour votre API GraphQL. Pour plus d'informations, consultez [Créer un schéma GraphQL](https://servicenow-prod.fluidtopics.net/bG2fHcKh5fNu2wiQncNC5g#build-graphql-scripted-schema "Créez un schéma GraphQL pour rendre les données disponibles aux requêtes GraphQL.").

L'activation des requêtes introspectives permet à l'explorateur GraphQL d'afficher les schémas sur l'instance dans l'explorateur de documentation et sous forme de suggestions de saisie semi-automatique, ce qui facilite la recherche de requêtes et de mutations. Pour plus d'informations, consultez [Activer les requêtes introspectives pour les schémas GraphQL](https://servicenow-prod.fluidtopics.net/jNQobbvRdLlgXbMG8~Am0A "Découvrez les requêtes et les mutations prises en charge par les schémas sur votre instance en activant l’introspection.").  
Remarque :  
N'utilisez pas de requêtes introspectives dans un environnement de production.

Rôle requis : graphql_schema_admin ou admin

## Pourquoi et quand exécuter cette tâche

L'explorateur GraphQL intègre l'IDE GraphiQL dans le Now Platformfichier . Pour plus d'informations sur l'interface, consultez le [fichier Lisez-moi GraphiQL](https://github.com/graphql/graphiql/blob/main/packages/graphiql/README.md) dans le référentiel GraphiQL GitHub .

## Procédure

1. Accédez à la ToutServices web du systèmeGraphQLExplorateur GraphQL.
2. **Facultatif :** Si vous avez activé l'introspection, dans la barre latérale gauche, sélectionnez l'icône Afficher l'Explorateur de documentation (icône ![Afficher l’Explorateur de documentation]()) pour afficher et rechercher les requêtes ou mutations disponibles.
3. Dans l'éditeur, entrez une requête dans le schéma.  
   Incluez les espaces de noms d'application et de schéma dans la requête. Pour plus d'informations sur les directives que vous pouvez appliquer, reportez-vous à la section [Directives et fonctions globales](https://servicenow-prod.fluidtopics.net/DxKJxnuEnkDHT2ptT5e55A#scripted-graph-ql__section_zdw_rnc_glb).  
   Cet exemple montre l'utilisation des espaces de noms application et schema :
   * Espace de noms de l'application : `x_graph_scope`
   * Espace de noms du schéma : `planète`

   {#test-gql-schema__ul_ihg_pzh_dlb}

       query {
         x_graph_scope {
           planet {
             findAll {
               name
               mass
               distance
             }
           }
         }
       }

   Cet exemple montre l'utilisation de la directive @defer pour diffuser les résultats du champ openedBy après la réponse à l'incident initiale.

       query findIncidents {
         now {
           incident {
             findAll {
               description {
                 displayValue
               }
               ...
               @defer(label: "my-label", if: true) {
                 openedBy {
                   firstName
                   lastName
                 }
               }
             }
           }
         }
       }

4. **Facultatif :** En bas de l'éditeur, sélectionnez Variables et entrez les variables nécessaires.
5. Sélectionnez l'icône Exécuter la requête ( ![icône Exécuter la requête]()).  
   Conseil :  
   Vous pouvez également utiliser un raccourci clavier. Pour afficher la liste des raccourcis clavier disponibles, sélectionnez l'icône Ouvrir la boîte de dialogue des touches courtes ( ![icône Ouvrir les touches courtes]()).  
   Le résultat de votre requête est renvoyé dans le volet droit.
6. **Facultatif :** Sélectionnez l'icône Ajouter un onglet (icône ![Ajouter un onglet]()) pour exécuter des requêtes supplémentaires.

## Que faire ensuite

Si vous avez besoin d'afficher une liste des requêtes précédentes, dans la barre latérale gauche, sélectionnez l'icône Afficher l'historique (icône ![Afficher l’historique]()).

Pour accéder aux données d'enregistrement d'un composant, vous pouvez créer un composant personnalisé et interroger votre schéma GraphQL scripté à partir du composant. Pour plus d'informations, consultez [Interroger un schéma GraphQL à partir d'un composant](https://servicenow-prod.fluidtopics.net/LvmilmVu_LIiB4iVdNMRqg "Accédez aux données d’enregistrement dans un composant en interrogeant votre schéma GraphQL scripté.").