Usar el Explorador de Graph para probar las API de Microsoft GraphUse Graph Explorer to try Microsoft Graph APIs

El Explorador de Graph es una herramienta para desarrolladores que le permite realizar cómodamente solicitudes de API de REST de Microsoft Graph y ver las respuestas correspondientes.Graph Explorer is a developer tool that lets you conveniently make Microsoft Graph REST API requests and view corresponding responses. Use el Explorador de Graph para probar las API en el espacio empresarial de ejemplo predeterminado para explorar las funcionalidades, o inicie sesión en su propio espacio empresarial y úselo como una herramienta de prototipos para satisfacer los escenarios de la aplicación.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. Esta herramienta incluye características útiles como fragmentos de código en C#, Java, JavaScript y Objective C; Microsoft Graph Toolkit y la integración de tarjetas adaptables; y mucho más.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 el Explorador de Graph para:Use Graph Explorer to:

  • Realice solicitudes de api de Microsoft Graph (GET, POST, PUT, PATCH y DELETE) y vea respuestas, incluido el código de respuesta y los encabezados y cuerpos.Make Microsoft Graph API requests (GET, POST, PUT, PATCH and DELETE) and see responses including response code and any headers and bodies.
  • Consentimiento de permisos.Consent to permissions.
  • Agregue un cuerpo de la solicitud y un encabezado de solicitud a la consulta.Add a request body and request header to your query.
  • Ver y copiar el token de acceso.View and copy the access token.
  • Ver consultas de ejemplo para diferentes servicios en Microsoft Graph.View sample queries for different services in Microsoft Graph.
  • Ver, descargar o eliminar las consultas que ejecutó en los últimos 30 días.View, download, or delete the queries you ran in the last 30 days.
  • Ver y copiar fragmentos de código de cada consulta que ejecute en C#, Java, JavaScript y Objective C.View and copy code snippets of each query you run in C#, Java, JavaScript, and Objective C.
  • Obtenga acceso a componentes de Microsoft Graph Toolkit y tarjetas adaptables para algunas consultas de ejemplo.Access Microsoft Graph Toolkit components and adaptive cards for some sample queries.
  • Compartir consultas, incluidos el cuerpo de la solicitud y los encabezados de solicitud.Share queries, including the request body and request headers.

El Explorador de Graph controla el proceso de autenticación por usted.Graph Explorer handles the authentication process for you. Personalice la experiencia contrayendo la barra lateral y cambiando el tema.Customize the experience by collapsing the sidebar and changing the theme.

ComenzarGet started

El Explorador de Graph es una aplicación web hospedada en el Centro para desarrolladores de Microsoft Graph.Graph Explorer is a web application hosted on the Microsoft Graph developer center. Es un proyecto de código abierto y agradecemos sus contribuciones y comentarios en el repositorio de GitHub.It's an open source project, and we welcome your contributions and feedback in the GitHub repo.

El Explorador de Graph incluye los siguientes elementos:Graph Explorer includes the following elements:

  1. Lista desplegable de verbo HTTPHTTP verb drop-down list
  2. Lista desplegable de versión de APIAPI version drop-down list
  3. Barra de direcciones de consulta de solicitudRequest query address bar
  4. Consulta de ejemploSample query
  5. Vínculo de documentación para la consulta de ejemploDocumentation link for the sample query

Captura de pantalla de la interfaz de usuario del Explorador de Graph

Realizar una solicitud GET en el Explorador de GraphMake a GET request in Graph Explorer

Para ejecutar una solicitud GET en el Explorador de Graph, no tiene que haber iniciado sesión.To run a GET request in Graph Explorer, you don’t have to be signed in. Solo tiene que hacer clic en una consulta de ejemplo y los datos de ejemplo se mostrarán en la vista previa de la respuesta.Just click a sample query and sample data will show in the response preview.

Captura de pantalla de una solicitud de ejemplo en el Explorador de Graph

Para realizar una solicitud:To make a request:

  1. Seleccione una consulta de ejemplo y ejecutarla.Select a sample query and run it.
  2. Obtenga el código de respuesta HTTP.Get the HTTP response code.
  3. Vea la respuesta de la API de Microsoft Graph con datos de ejemplo.See the response from the Microsoft Graph API with sample data.

Cuando inicie sesión en el Explorador de Graph y haga clic en la misma consulta, la respuesta se devolverá con datos reales del espacio empresarial en el que ha iniciado sesión.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.

Ejecución de solicitudes que no son GET en el Explorador de GraphRunning non-GET requests in Graph Explorer

Para probar las solicitudes POST, PUT, PATCH y DELETE, inicie sesión en el Explorador de Graph con una cuenta de Microsoft 365. Puede ser una cuenta organizativa con fines de prueba o demostración.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 obtener una suscripción de desarrollador de Microsoft 365 E5 de ejemplo gratuita, junto con herramientas y otros recursos para ayudarle a crear soluciones para la plataforma de Microsoft 365, únase al Programa de desarrolladores de 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

Si decide iniciar sesión con su cuenta organizativa, la ejecución de una solicitud que no sea GET puede afectar a los datos del espacio empresarial.If you choose to sign in using your organizational account, running a non-GET request can affect the data in the tenant.

Por ejemplo, para ejecutar una solicitud POST, seleccione POST en la lista desplegable para el verbo HTTP y agregue un cuerpo de solicitud y encabezados de solicitud según corresponda.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 pantalla de una solicitud POST en el Explorador de Graph

  1. Seleccione una consulta de ejemplo POST.Select a POST sample query.
  2. Cuerpo de la solicitud de actualización; por ejemplo, asigne un nombre a la aplicación.Update Request body; for example, give the application a name.
  3. Haga clic en Ejecutar consulta.Click Run query.
  4. Vea la respuesta de la API de Microsoft Graph.See the response from the Microsoft Graph API.

Para ver la respuesta en un formato distinto del json predeterminado, elija la pestaña Encabezados de solicitud en el panel de solicitudes, defina el par clave-valor y haga clic en Agregar.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.

Captura de pantalla que muestra la pestaña Encabezados de solicitud en el Explorador de Graph

Siguientes pasosNext steps