Utilisation des clients GraphQL

Vous pouvez effectuer des requêtes sur des données ARISE réelles à l’aide de divers clients et bibliothèques GraphQL.

Utilisation d’IDE clients GraphQL

Il existe de nombreux IDE clients GraphQL open source que vous pouvez utiliser pour accéder à l’API GraphQL d’ARISE.

Consultez la section Effectuer des appels avec GraphQL pour obtenir des informations détaillées sur les méthodes HTTP, l’authentification et la structure des appels GraphQL.

Commencez par choisir un client. Parmi les options courantes, on trouve GraphiQL, Insomnia et Altair (version bureau/web/extension). Vous pouvez consulter la liste complète des clients dans le répertoire des outils de l’organisation GraphQL.

Les instructions génériques suivantes fonctionnent avec la plupart des clients GraphQL :

1. Pointez le client vers l’endpoint GraphQL : https://api.iiens.net/graphql/v1.
2. Ajoutez un en-tête Authorization : Authorization: Bearer TOKEN (remplacez TOKEN par votre jeton d’accès personnel ARISE. Pour plus d’informations, consultez la section Authentification avec un jeton d’accès personnel OAuth).
3. Définissez la méthode de requête sur POST ou, si c’est possible, utilisez le mode GraphQL fourni par le client.
4. Saisissez votre requête ou votre mutation dans l’éditeur et, si nécessaire, fournissez des variables dans le panneau “Variables”. Exemple :

query {
  profile {
    id
  } 
}

5. Si votre client nécessite d’un schéma pour le rendu de la documentation ou la saisie semi-automatique, récupérez-le via une requête d’introspection GraphQL. De nombreux clients peuvent le faire automatiquement à partir du panneau “Docs”. Requête d’introspection minimale :

query IntrospectionQuery {
  __schema {
    types {
      name
    }
  }
}

6. Exécutez la requête et examinez la réponse JSON. La requête de l’exemple devrait renvoyer l’identifiant associé au jeton d’accès personnel ARISE avec lequel vous vous êtes authentifié.

Utilisez l’interface utilisateur du client pour explorer la documentation, exécuter des requêtes et enregistrer des requêtes selon vos besoins.

Recommendations de clients par langage

Work In Progress