Utiliser l’Afficheur Graph pour essayer les API Microsoft Graph

L’Afficheur Graph est un outil de développement qui vous permet d’effectuer facilement des demandes d’API REST Microsoft Graph et d’afficher les réponses correspondantes. Utilisez l’Afficheur Graph pour essayer des API sur l’exemple de client par défaut afin d’explorer les fonctionnalités, ou connectez-vous à votre propre client et utilisez-le comme outil de prototypage pour répondre à vos scénarios d’application. Cet outil inclut des fonctionnalités utiles telles que des extraits de code (C#, Java et JavaScript), Microsoft Graph Toolkit et l’intégration de cartes adaptatives, etc.

Utilisez l’Afficheur Graph pour :

  • Effectuer des demandes d’API Microsoft Graph (GET, POST, PUT, PATCH et DELETE) et afficher les réponses, y compris le code de réponse, les en-têtes et les corps.
  • Accorder des autorisations. L’Afficheur Graph prend uniquement en charge les autorisations déléguées.
  • Ajouter un corps et un en-tête de demande à votre requête.
  • Afficher et copier le jeton d’accès.
  • Afficher des exemples de requêtes pour différents services dans Microsoft Graph.
  • Affichez, téléchargez ou supprimez les requêtes que vous avez exécutées au cours des 30 derniers jours.
  • Affichez et copiez les extraits de code de chaque requête que vous exécutez en C#, Java et JavaScript.
  • Accéder aux cartes adaptatives et composants du Kit de ressources Microsoft Graph pour certains exemples de requêtes.
  • Partager des requêtes, notamment le corps et les en-têtes de la demande.

L’Afficheur Graph gère le processus d’authentification pour vous. Personnaliser l’expérience en réduisant la barre latérale ou en modifiant le thème.

Prise en main

L’Afficheur Graph est une application web hébergée sur le Centre de développement Microsoft Graph. Il s’agit d’un projet open source. Vos contributions et commentaires sont les bienvenus dans le référentiel GitHub.

L’Afficheur Graph inclut les éléments suivants :

  1. Liste déroulante de verbes HTTP
  2. Liste déroulante des versions d’API
  3. Barre d’adresse des requêtes de demande
  4. Exemple de requête
  5. Lien de documentation pour l’exemple de requête

Capture d’écran de l’interface utilisateur d’Afficheur Graph.

Effectuer une requête GET dans l’Afficheur Graph

Vous n’avez pas besoin d’être connecté pour exécuter une requête GET dans l’Afficheur Graph. Il vous suffit de choisir un exemple de requête, et les exemples de données s’affichent dans la préversion de la réponse.

Capture d’écran d’un exemple de demande dans l’Afficheur Graph.

Pour effectuer une requête :

  1. Sélectionnez un exemple de requête, puis exécutez-le.
  2. Obtenez le code de réponse HTTP.
  3. Affichez la réponse de l’API Microsoft Graph avec des exemples de données.

Lorsque vous vous connectez à l’Explorateur Graph et que vous choisissez la même requête, la réponse est retournée avec les données réelles du locataire auquel vous vous êtes connecté.

Exécuter des requêtes non GET dans l’Explorateur Graph

Pour essayer les requêtes POST, PUT, PATCH et DELETE, connectez-vous à l’Explorateur Graph à l’aide d’un compte Microsoft 365. Il peut s’agir d’un compte professionnel à des fins de test ou de démonstration. Pour obtenir un exemple gratuit d’abonnement Microsoft 365 E5 pour les développeurs, ainsi que des outils et d’autres ressources afin de vous aider à créer des solutions pour la plateforme Microsoft 365, rejoignez le Programme pour les développeurs Microsoft 365.

Important

Si vous choisissez de vous connecter à l’aide de votre compte professionnel, l’exécution d’une demande non GET peut affecter les données du locataire.

Par exemple, pour exécuter une requête POST, sélectionnez POST dans la liste déroulante pour le verbe HTTP, puis ajoutez un corps de demande et des en-têtes de demande selon le cas.

Capture d’écran d’une requête POST dans l’Afficheur Graph.

  1. Sélectionnez un exemple de requête POST.
  2. Mettez à jour le Corps de la demande ; par exemple, donnez un nom à l’application.
  3. Sélectionnez Exécuter la requête.
  4. Consultez la réponse de l’API Microsoft Graph.

Pour afficher la réponse dans un format autre que le format JSON par défaut, sélectionnez l’onglet En-têtes de demande dans le volet de demande, définissez la paire clé/valeur, puis cliquez sur Ajouter.

Capture d’écran montrant l’onglet En-têtes de demande dans l’Afficheur Graph.

Prochaines étapes