GraphQL
Wat is GraphQL?
GraphQL is een querytaal en runtime voor API's. Facebook ontwikkelde het in 2012 en bracht het in 2015 uit als open source. Bij een REST API geeft elk endpoint een vaste structuur terug. Bij GraphQL beschrijft de client welke velden hij nodig heeft, en de server geeft precies die terug, in één verzoek. Een schema beschrijft alle types en velden die de API biedt.
Kernbegrippen
Schema en types: het schema legt elk type en veld vast, en elke query wordt daartegen gecontroleerd voordat hij draait.
Queries: gegevens lezen. De vorm van de query komt overeen met de vorm van het antwoord.
Mutations: gegevens wijzigen.
Subscriptions: updates ontvangen als gegevens veranderen.
Introspectie: de API kan zijn eigen schema beschrijven. Tools gebruiken dat voor documentatie en automatisch aanvullen.
Directives: annotaties zoals @include en @skip die bepalen hoe een query wordt uitgevoerd.
Eén endpoint: alle verzoeken gaan naar dezelfde URL.
Wanneer GraphQL past
Meerdere clients, één backend: een website en een mobiele app vragen verschillende velden op bij dezelfde API.
Geen overbodige gegevens: de client krijgt alleen de velden die hij opvroeg.
Uitbreiden zonder te breken: nieuwe velden en types voeg je toe zonder dat bestaande queries erdoor veranderen.
Nadelen
GraphQL vraagt meer werk aan de serverkant. HTTP-caching is lastiger dan bij REST, omdat de meeste verzoeken naar één endpoint gaan. Zonder grenzen aan de diepte of kosten van een query kan een client een query sturen die erg zwaar is om uit te voeren. Voor een eenvoudige API met één client is REST vaak de eenvoudigere keuze.
Onze ervaring
Bij een websiterelaunch gebruikten we GraphQL om technische documentatie in de site te laden en automatisch actueel te houden.
Hulp nodig met GraphQL?
Ons team heeft uitgebreide ervaring met GraphQL. We helpen je graag bij het bouwen, integreren of optimaliseren van je project.
Bekijk onze diensten