GraphQL API

Si su equipo quiere consultar los datos de Zauru desde una aplicación externa —por ejemplo, mostrar las filas de sus WebApp Tables en un tablero propio o alimentar un reporte personalizado— GraphQL es la puerta más cómoda. Zauru ofrece un endpoint de GraphQL que le permite consultar la información de su entidad (y sus WebApp Tables) de forma flexible y eficiente. El acceso a GraphQL se realiza por medio de un token JWT generado por Zauru, y en esta página le explicamos cómo obtenerlo y utilizarlo.

Obtener un Token JWT

Para acceder al endpoint de GraphQL, primero necesita obtener un token JWT. El token expira en 5 días y se obtiene desde el endpoint de GraphQL de Zauru.

Los pasos para obtener su token son:

1. Ir a "WebApps".
2. Seleccionar "GraphQL".

Zauru le mostrará su token JWT, la URL del endpoint de GraphQL y la fecha de expiración del token.

Con el token en sus manos, sus aplicaciones ya pueden leer la información de Zauru desde afuera. Recuerde que el token expira a los cinco días: cuando eso suceda, puede volver al módulo de GraphQL y generar uno nuevo siguiendo estos mismos pasos.

API (llamadas desde sistemas externos)

Obtener token JWT para GraphQL

curl -v \
  -H "Accept: application/json" \
  -H "Content-type: application/json" \
  -H "X-User-Email: prueba@zauru.com" \
  -H "X-User-Token: XSDFKK09238487DLFS" \
  https://app.zauru.com/apps/graphql.json

Esto devolverá un JSON similar a este:

{
  "status": 200,
  "message": "ok",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires": "2024-05-21T10:00:48Z",
  "expiresMsg": "21/05/2024 10:00:48 (5d y 00:00:00 restantes)",
  "graphqlUrl": "https://graphql.zauru.com/v1/graphql"
}

Una vez obtenido el token, puede utilizarlo para hacer consultas GraphQL directamente contra la URL proporcionada en graphqlUrl, enviando el token en el encabezado Authorization:

curl -v \
  -H "Content-type: application/json" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -d '{"query": "{ webapp_table_rows { id data } }"}' \
  https://graphql.zauru.com/v1/graphql