Faire une requête

Si vous avez suivi le Démarrage rapide GraphQL, vous avez déjà une fonction d’aide graphql. Obtenez un jeton ou une clé API en utilisant S’authentifier avec l’API, puis développez cette fonction d’aide ici.

Requête avec des variables

La plupart des requêtes nécessitent un ID. Utilisez les variables GraphQL pour les passer :

index.js

const result = await graphql(token, `
    query GetGroup($id: ID!) {
        group(id: $id) {
            id
            name
            credit
        }
    }
`, { id: '<your-group-id>' });

Trouvez votre ID de groupe

Vous pouvez découvrir vos groupes en interrogeant les adhésions de votre utilisateur :

index.js

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);

Cela retourne tous les groupes auxquels appartient votre utilisateur API. Vous aurez besoin d’un ID de groupe pour la plupart des opérations — envoyer des documents, lister des modèles, gérer les contacts.

astuce

Testez les requêtes de manière interactive dans le GraphiQL Explorer avant d’écrire du code. Voir les exemples de requêtes complexes pour plus de modèles de requêtes imbriquées.

Utilisation d’une bibliothèque cliente GraphQL

L’approche fetch fonctionne bien pour la plupart des intégrations. Si vous créez quelque chose de plus complexe, considérez un client GraphQL dédié :

• graphql-request — léger, basé sur les promesses
• Apollo Client — complet, avec mise en cache et intégration React
• Axios — client HTTP général, fonctionne bien pour GraphQL

Voir la page des bibliothèques pour plus de détails.