Usar o Explorador do Graph para experimentar as APIs do Microsoft GraphUse Graph Explorer to try Microsoft Graph APIs

O Explorador do Graph é uma ferramenta de desenvolvedor que permite que você faça convenientemente solicitações da API REST do Microsoft Graph e veja as respostas correspondentes.Graph Explorer is a developer tool that lets you conveniently make Microsoft Graph REST API requests and view corresponding responses. Use o Explorador do Graph para experimentar APIs no exemplo de locatário padrão para explorar as funcionalidades ou entre em seu próprio locatário e use-o como uma ferramenta de criação de protótipo para atender aos cenários do aplicativo.Use Graph Explorer to try APIs on the default sample tenant to explore capabilities, or sign in to your own tenant and use it as a prototyping tool to fulfill your app scenarios. Essa ferramenta inclui recursos úteis, como trechos de código em C#, Java, JavaScript e Objective C; Integração de cartões adaptáveis e kits de ferramentas do Microsoft Graph; e muito mais.This tool includes helpful features such as code snippets in C#, Java, JavaScript, and Objective C; Microsoft Graph Toolkit and adaptive cards integration; and more.

Use o Explorador do Graph para:Use Graph Explorer to:

  • Faça solicitações da API do Microsoft Graph (GET, POST, PUT, PATCH e DELETE) e veja respostas, incluindo o código de resposta e quaisquer headers e corpos.Make Microsoft Graph API requests (GET, POST, PUT, PATCH and DELETE) and see responses including response code and any headers and bodies.
  • Consentimento para permissões.Consent to permissions.
  • Adicione um corpo de solicitação e um header de solicitação à sua consulta.Add a request body and request header to your query.
  • Exibir e copiar o token de acesso.View and copy the access token.
  • Veja exemplos de consultas para diferentes serviços no Microsoft Graph.View sample queries for different services in Microsoft Graph.
  • Exibir, baixar ou excluir as consultas que você fez nos últimos 30 dias.View, download, or delete the queries you ran in the last 30 days.
  • Exibir e copiar trechos de código de cada consulta que você executar em C#, Java, JavaScript e Objective C.View and copy code snippets of each query you run in C#, Java, JavaScript, and Objective C.
  • Acesse os componentes e cartões adaptáveis do Microsoft Graph Toolkit para algumas consultas de exemplo.Access Microsoft Graph Toolkit components and adaptive cards for some sample queries.
  • Compartilhe consultas, incluindo o corpo da solicitação e os headers de solicitação.Share queries, including the request body and request headers.

O Explorador do Graph lida com o processo de autenticação para você.Graph Explorer handles the authentication process for you. Personalize a experiência repondo a barra lateral e alterando o tema.Customize the experience by collapsing the sidebar and changing the theme.

IntroduçãoGet started

O Graph Explorer é um aplicativo Web hospedado na central de desenvolvedores do Microsoft Graph.Graph Explorer is a web application hosted on the Microsoft Graph developer center. É um projeto de código aberto e damos as boas-vindas às suas contribuições e comentários no repositório do GitHub.It's an open source project, and we welcome your contributions and feedback in the GitHub repo.

O Graph Explorer inclui os seguintes elementos:Graph Explorer includes the following elements:

  1. Lista drop-down de verbo HTTPHTTP verb drop-down list
  2. Lista drop-down de versão da APIAPI version drop-down list
  3. Barra de endereços de consulta de solicitaçãoRequest query address bar
  4. Consulta de exemploSample query
  5. Link de documentação para a consulta de exemploDocumentation link for the sample query

Captura de tela da interface do usuário do Graph Explorer

Fazer uma solicitação GET no Explorador do GraphMake a GET request in Graph Explorer

Para executar uma solicitação GET no Explorador do Graph, você não precisa entrar.To run a GET request in Graph Explorer, you don’t have to be signed in. Basta clicar em um exemplo de consulta e mostrar dados de exemplo na visualização da resposta.Just click a sample query and sample data will show in the response preview.

Captura de tela de uma solicitação de exemplo no Explorador do Graph

Para fazer uma solicitação:To make a request:

  1. Selecione uma consulta de exemplo e execute-a.Select a sample query and run it.
  2. Obter o código de resposta HTTP.Get the HTTP response code.
  3. Veja a resposta da API do Microsoft Graph com dados de exemplo.See the response from the Microsoft Graph API with sample data.

Quando você entrar no Explorador do Graph e clicar na mesma consulta, a resposta será retornada com dados reais do locatário em que você se inscreveu.When you sign in to Graph Explorer and click the same query, the response will be returned with real data from the tenant you signed in to.

Executando solicitações não GET no Explorador do GraphRunning non-GET requests in Graph Explorer

Para experimentar solicitações POST, PUT, PATCH e DELETE, entre no Explorador do Graph usando uma conta do Microsoft 365. Pode ser uma conta organizacional para fins de teste ou demonstração.To try POST, PUT, PATCH and DELETE requests, sign in to Graph Explorer using a Microsoft 365 account.This can be an organizational account for testing or demonstration purpose. Para obter um exemplo gratuito de assinatura de desenvolvedor do Microsoft 365 E5, juntamente com ferramentas e outros recursos para ajudá-lo a criar soluções para a plataforma Microsoft 365, participe do Programa para Desenvolvedores do Microsoft 365.To get a free sample Microsoft 365 E5 developer subscription, along with tools and other resources to help you build solutions for the Microsoft 365 platform, join the Microsoft 365 Developer Program.

Importante

Se você optar por entrar usando sua conta organizacional, executar uma solicitação não GET pode afetar os dados no locatário.If you choose to sign in using your organizational account, running a non-GET request can affect the data in the tenant.

Por exemplo, para executar uma solicitação POST, selecione POST na lista drop-down para o verbo HTTP e adicione um corpo de solicitação e cabeçalhos de solicitação conforme apropriado.For example, to run a POST request, select POST in the drop-down list for the HTTP verb, and add a request body and request headers as appropriate.

Captura de tela de uma solicitação POST no Explorador do Graph

  1. Selecione uma consulta de exemplo POST.Select a POST sample query.
  2. Atualizar corpo da solicitação; por exemplo, dê um nome ao aplicativo.Update Request body; for example, give the application a name.
  3. Clique em Executar consulta.Click Run query.
  4. Veja a resposta da API do Microsoft Graph.See the response from the Microsoft Graph API.

Para exibir a resposta em um formato diferente do JSON padrão, escolha a guia Solicitação de headers no painel de solicitação, defina o par chave/valor e clique em Adicionar.To view the response in a format other than the default JSON, choose the Request headers tab in the request pane, define the key/value pair, and click Add.

Screenshot that shows the Request headers tab in Graph Explorer

Próximas etapasNext steps