Realizar una Consulta
Si seguiste el Inicio rápido de GraphQL, ya tienes una función auxiliar graphql. Obtén un token o una clave API usando Autenticarse con la API, luego construye sobre esa función auxiliar aquí.
Consulta con variables
La mayoría de las consultas necesitan un ID. Usa variables de GraphQL para pasarlos:
const result = await graphql(token, `
query GetGroup($id: ID!) {
group(id: $id) {
id
name
credit
}
}
`, { id: '<your-group-id>' });
Encuentra tu ID de grupo
Puedes descubrir tus grupos consultando las membresías de tu usuario:
async function main() {
const token = '<token-or-api-key>';
const result = await graphql(token, `
query {
user {
memberConnection(first: 10) {
groupMembers {
group {
id
name
}
}
}
}
}
`);
console.log(JSON.stringify(result, null, 2));
}
main().catch(console.error);
Esto retorna todos los grupos a los que pertenece tu usuario API. Necesitarás un ID de grupo para la mayoría de las operaciones — enviar documentos, listar plantillas, gestionar contactos.
Prueba consultas de forma interactiva en el Explorador GraphiQL antes de escribir código. Consulta los ejemplos de consultas complejas para ver más patrones de consultas anidadas.
Uso de una biblioteca cliente GraphQL
El enfoque fetch funciona bien para la mayoría de las integraciones. Si estás construyendo algo más complejo, considera un cliente GraphQL dedicado:
- graphql-request — ligero, basado en promesas
- Apollo Client — con características completas, con caché e integración con React
- Axios — cliente HTTP general, funciona bien para GraphQL
Consulta la página de bibliotecas para más detalles.