Consultar GraphQL desde Insomnia y Postman

Consumir un servidor GraphQL no se limita al playground integrado. Puedes hacer las mismas consultas desde herramientas externas como Insomnia o Postman, lo que te da flexibilidad para integrar tu API en cualquier flujo de trabajo. Esto es útil si ya usas estos clientes para probar APIs REST y quieres unificar tu entorno de pruebas.

¿Cómo hacer una consulta GraphQL desde Insomnia?

Insomnia tiene soporte nativo para GraphQL, así que el proceso es directo y visual.

Dentro de tu carpeta de trabajo, crea un nuevo request y selecciona la opción New GraphQL Request. Notarás que aparece marcado distinto a los endpoints REST tradicionales. Por defecto, la petición se configura como POST, porque todas las consultas de GraphQL viajan por ese método HTTP.

Luego pega la URL de tu servidor, que en el ejemplo corre en el puerto 3000 sobre la ruta /graphql, y escribe la consulta:

graphql { hello }

Al enviar el request, recibes el mismo hola mundo que devuelve el playground.

¿Por qué GraphQL siempre usa POST? Porque las consultas viajan en el cuerpo de la petición, no en la URL. Esto permite enviar queries largas y estructuradas sin las limitaciones de tamaño del método GET.

¿Cómo configurar una petición GraphQL en Postman?

Postman también soporta GraphQL, aunque la configuración requiere un par de pasos extra.

Crea un nuevo request, nómbralo por ejemplo hello, y cambia el método a POST. Ve a la pestaña Body y selecciona el tipo GraphQL. Ahí escribes la misma query:

graphql { hello }

Dale a Send y recibirás la respuesta del servidor.

¿Insomnia o Postman para GraphQL? Ambos funcionan igual de bien. Insomnia tiene un tipo de request específico para GraphQL más visible, mientras que Postman lo configura desde el body. La elección depende del cliente que ya uses.

¿Qué opciones tienes para consumir un servidor GraphQL?

En este punto del curso ya cuentas con tres formas válidas de probar tu API:

• El playground que viene integrado con el servidor GraphQL.
• Insomnia, usando el tipo de request New GraphQL Request.
• Postman, configurando el body como GraphQL con método POST.

La consulta hello que devuelve un hola mundo es solo el inicio. En la próxima clase entrarás al sistema de tipos de GraphQL, que es donde la herramienta empieza a mostrar todo su poder.

¿Cuál de estos clientes usas tú normalmente para probar APIs? Cuéntame en los comentarios.