Eine Abfrage erstellen

Wenn Sie dem GraphQL Quickstart gefolgt sind, haben Sie bereits eine graphql Hilfsfunktion. Holen Sie sich ein Token oder einen API-Schlüssel mit Authentifizieren mit der API und bauen Sie dann auf dieser Hilfsfunktion hier auf.

Abfrage mit Variablen

Die meisten Abfragen benötigen eine ID. Verwenden Sie GraphQL-Variablen, um diese zu übergeben:

index.js

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

Finden Sie Ihre Gruppen-ID

Sie können Ihre Gruppen entdecken, indem Sie die Mitgliedschaften Ihres Benutzers abfragen:

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

Dies gibt alle Gruppen zurück, denen Ihr API-Benutzer angehört. Für die meisten Operationen benötigen Sie eine Gruppen-ID — zum Versenden von Dokumenten, Auflisten von Vorlagen, Verwalten von Kontakten.

Tipp

Testen Sie Abfragen interaktiv im GraphiQL Explorer, bevor Sie Code schreiben. Siehe die Beispiele für komplexe Abfragen für weitere verschachtelte Abfragemuster.

Verwendung einer GraphQL-Clientbibliothek

Der fetch-Ansatz eignet sich gut für die meisten Integrationen. Wenn Sie etwas Komplexeres bauen, ziehen Sie eine dedizierte GraphQL-Clientbibliothek in Betracht:

• graphql-request — leichtgewichtig, auf Promises basierend
• Apollo Client — umfangreich mit Caching und React-Integration
• Axios — allgemeiner HTTP-Client, funktioniert gut für GraphQL

Siehe die Seite mit Bibliotheken für weitere Details.