Ga naar hoofdinhoud

GraphQL

Meister1 maakt gebruik van een GraphQL API. GraphQL is een querytaal waarmee de client kan bepalen welke gegevens hij nodig heeft.

Hier laten we kort zien hoe een HTTP-verzoek in GraphQL eruitziet. We bekijken ook enkele typische gebruikssituaties.

Endpoint: https://api.meister1.com/graphql

pas op

Voor de queries moet een Authorization-header met het accessToken worden gebruikt (zie Autorisatie)

Algemeen​

In principe ziet elk verzoek er hetzelfde uit. Het is een POST-verzoek. Het schema dat als antwoord wordt verwacht, is gedefinieerd in de body.

Verzoek​

query {
  viewer {
    id
    email
  }
}

cURL​

curl 'https://api.meister1.com/graphql' -H 'Content-Type: application/json' \
 --data-binary '{"query":"query {\n  viewer {\n    id\n    email\n  }\n}"}' --compressed

Antwoord​

{
  "data": {
    "viewer": {
      "id": "VSFlcgox",
      "email": "user@meister1.de"
    }
  }
}

Query builder​

Wissel hierboven tussen Lezen (query's) en Schrijven (mutations). Selecteer een of meer query's of mutations — ze worden samengevoegd en de GraphQL-operatie wordt live gegenereerd. Voor mutations worden ook de mogelijke waarden (bijv. de leadstatus) getoond.

Beschikbare query's
Geselecteerde query's

Nog geen query's geselecteerd — alleen de basisquery wordt getoond.

GraphQL Query
query {
  viewer {
    id
    email
  }
}