Persisted Queries
Usa consultas GraphQL para crear endpoints predefinidos como en REST, obteniendo las ventajas de ambas APIs.
Click to watch tutorial video - 08:19
En una API REST, creamos múltiples endpoints, cada uno devolviendo un conjunto predefinido de datos. En una API GraphQL, en cambio, enviamos cualquier consulta a un único endpoint, que devuelve exactamente los datos solicitados.
Las persisted queries son consultas GraphQL normales, pero se almacenan en el servidor y se acceden bajo su propia URL, emulando así un endpoint REST. Proporcionan las ventajas de estas dos APIs, evitando sus desventajas:
| Ventajas | Desventajas |
|---|---|
✅ Se accede mediante GET o POST | POST |
| ✅ Puede cachearse en el servidor o en una CDN | |
| ✅ Es segura: solo se expone la información prevista | |
| ✅ Sin sub/sobre obtención de datos, todos los datos se recuperan en una sola petición | |
| ✅ Permite una iteración rápida del proyecto | |
| ✅ Puede ser autodocumentada | |
| ✅ Proporciona clientes para crear y publicar la consulta |
Una vez publicada la persisted query, podemos ejecutarla a través de su permalink.
La persisted query puede ejecutarse mediante el cliente GraphiQL, o también directamente en el navegador (ya que se accede mediante GET), y obtendremos los datos solicitados en formato JSON:
Las persisted queries pueden gestionarse mediante categorías y jerarquías.
