Wat is GraphQL?

Wou je dat een API je precies gaf waar je om vroeg? GraphQL is een querytaal voor API's waarmee clients precies de gegevens kunnen opvragen die ze nodig hebben.

REST-eindpunten geven een vaste structuur terug, waardoor je te veel gegevens ophaalt — je vraagt om de naam van een gebruiker, maar downloadt het volledige profiel, wat bandbreedte verspilt.

Het omgekeerde probleem is te weinig gegevens ophalen: één eindpunt is niet genoeg, dus je koppelt aanroepen aan elkaar voor gebruikers, daarna berichten en vervolgens reacties — veel heen-en-weerritten die je vertragen.

GraphQL lost beide problemen op: clients vragen vanaf één eindpunt precies de velden op die ze nodig hebben, zodat je minder aanvragen en een kleinere gegevensoverdracht hebt.

In het hart van elke GraphQL-API staat het schema — het contract. Het definieert elk type waar clients query's op kunnen uitvoeren en hoe die types samenhangen, geschreven in SDL.

Types worden gedefinieerd in SDL. Hier heeft een User de velden id, name en email; de ! markeert een veld als niet-nullbaar.

Een query is de manier waarop een client gegevens opvraagt. De structuur ervan weerspiegelt de vorm die je wilt, en alleen de velden die je opsomt worden opgehaald — ook uit geneste objecten.

Dit is een eenvoudige query: vraag alleen id en name op, en dat is alles wat de server terugstuurt voor de gebruiker met id 1. Niets extra's.

Waarom zou je voor GraphQL kiezen? Efficiënt gegevens ophalen, een sterk getypeerd schema dat fouten voorkomt, probleemloze evolutie van je API en uitstekende hulpmiddelen zoals GraphiQL.

GraphQL komt goed tot zijn recht bij complexe, onderling verbonden gegevens, meerdere clientplatforms op één API, gateways voor microservices en snelle iteratie aan de frontend.

Je kent nu de basis: GraphQL voorkomt dat je te veel of te weinig gegevens ophaalt, het schema is het contract en query's vragen precies op wat je wilt. Hierna volgt Spring Boot.