Explorando Graph Explorer

¿Qué es?

Antes de construir aplicaciones basadas en servicios de terceros, suelen ser necesarias pruebas de funcionamiento. En el caso de la API de Microsoft Graph, existe Microsoft Graph Explorer. Una herramienta gratuita de código abierto disponible desde cualquier navegador moderno; pensada para que desarrolladores puedan:

Probar las API de Microsoft Graph.
Obtener información sobre los permisos necesarios para las distintas API.
Explorar todos los recursos disponibles en Microsoft Graph.
Explorar los componentes del kit de herramientas de Microsoft Graph, las tarjetas adaptables y los fragmentos de código para las consultas.

Para hacer uso de Microsoft Graph Explorer, da click aquí.

¿Cómo funciona?

La siguiente captura muestra el Microsoft Graph Explorer.

Lista desplegable con verbos HTTP: GET, POST, PUT, PATCH y DELETE.
Lista desplegable de versiones: v1.0 o beta.
Editor de consultas: para modificar la consulta.
Ejecutar consulta: ver los resultados de la consulta.
Consultas de muestra de la API: listas para buscar y probar. Cuando se selecciona una opción, esta se modificará en el editor de consultas.
Vínculos a la documentación de API de cada consulta de ejemplo.
Pestaña Modificar permisos: donde se enumeran todos los permisos que pueden necesitarse para ejecutar la consulta.
Response preview: en formato JSON.
History: todas las consultas que se ejecutan en el Explorador de Graph se guardan durante 30 días en la pestaña Historial.

Realiza solicitudes

Como primer ejemplo, podemos realizar una consulta a nuestro perfil. Para esto, usaremos una de las consultas de muestra, estas están dispnonibles para usar aunque no hayas iniciado sesión e un tenant de prueba.

Ve a la parte lateral derecha y selecciona my profile dentro del menú de getting started. Esto cambiará el endpoint dentro del editor de consultas. Da click en Run query. Y espera la respuesta.

Observa que además del resultado de la consulta en Response preview, se habilita un cuadro con un código de status de la consulta. Un 200 indica que todo ha ido bien, para saber más de códigos de status da click aquí.