GraphQL vs. REST: Een Complete Gids

API’s zijn de ruggengraat van moderne web- en mobiele applicaties. Bijna elke app op je telefoon en elke website die je bezoekt, gebruikt API’s om de gegevens op je scherm op te halen en ermee te werken. 

REST en GraphQL zijn twee van de meest gangbare paradigma’s voor API-ontwerp. In deze gids verkennen we de fundamentele verschillen, voordelen en beste use-cases voor beide, zodat je kunt kiezen welke aanpak het beste past bij je eigen project of projecten.

Wacht even, wat is een API?
Als je helemaal nieuw bent met het concept van een API (Application Programming Interface), overweeg dan onze Streamlined Data Ingestion with Pandas-cursus. Die leert je hoe applicaties via API’s met andere programma’s kunnen communiceren — en omgekeerd — zonder dat beide kanten de details van elkaars interne werking hoeven te kennen. De cursus maakt je wegwijs in de regels en protocollen die applicaties gebruiken om informatie aan te vragen en uit te wisselen.

Wat is REST?

REST (Representational State Transfer) is een architecturale stijl die sinds het begin van de jaren 2000 wordt gebruikt om webservices te ontwikkelen. Het definieert een set beperkingen en principes om schaalbare en stateless API’s te bouwen. REST API’s (ook wel RESTful API’s genoemd) zijn ontworpen om lichtgewicht te zijn en kunnen worden gebruikt in elke taal of op elk platform dat HTTP ondersteunt.

Als je nieuw bent met REST API’s, raad ik aan om eerst te leren ermee te werken voordat je je eigen API ontwikkelt. Zo krijg je gevoel voor hoe ze werken en wat de best practices zijn. Bekijk Intermediate Importing Data in Python of Intermediate Importing Data in R om te beginnen. Beide cursussen hebben hoofdstukken over HTTP-verzoeken doen, web-scraping en andere leuke dingen. 

Belangrijke concepten van REST API’s

Laten we de concepten van REST begrijpen. 

Statelessness

Elke interactie tussen de client en de server staat op zichzelf. De server slaat tussen verzoeken geen sessiegegevens van de client op, wat betekent dat elk verzoek van een client aan een server alle informatie moet bevatten die nodig is om dat verzoek te begrijpen en te verwerken.

Resource-gebaseerd

Elk stukje data of functionaliteit wordt behandeld als een resource die kan worden geïdentificeerd en gemanipuleerd via een unieke identifier, doorgaans een URI (Uniform Resource Identifier). 

In een e-commerceapplicatie kunnen resources bijvoorbeeld klanten, producten, bestellingen, enz. zijn. Elke resource wordt geïdentificeerd door een unieke URI die fungeert als een adres waar de resource toegankelijk is. Bijvoorbeeld:

• /products kan verwijzen naar de collectie van alle producten.

• /products/123 kan verwijzen naar een specifiek product met ID 123.

HTTP-methoden

RESTful API’s gebruiken doorgaans standaard HTTP-methoden om operaties op resources uit te voeren:

• GET: Gegevens ophalen van een server (bijv. een lijst met producten ophalen).

• POST: Gegevens naar de server sturen (bijv. een nieuw product aanmaken).

• PUT: Een bestaande resource bijwerken (bijv. productdetails wijzigen).

• DELETE: Een resource verwijderen (bijv. een product verwijderen).

Een standaard GET-verzoek ziet er zo uit:

Voorbeeld van een REST-verzoek en -antwoord. Afbeelding door de auteur.

REST API’s gebruiken ook standaard HTTP-statuscodes om fouten, succes en andere responses te communiceren. En ja, status 418 I’m a teapot bestaat echt!

Dataformaten

Een RESTful API kan verschillende formaten gebruiken om data te representeren en uit te wisselen, waaronder JSON, XML, HTML, platte tekst, YAML en CSV.

Wat is GraphQL?

GraphQL is een open-source querytaal en runtime voor API’s waarmee clients precies de data kunnen opvragen die ze nodig hebben, en niet meer dan dat. Het werd oorspronkelijk in 2012 intern ontwikkeld door Meta (voorheen Facebook) om het ophalen van data voor hun mobiele apps te optimaliseren en in 2015 vrijgegeven voor openbaar gebruik.

Belangrijke concepten van GraphQL API’s

Laten we de belangrijkste ideeën van GraphQL bekijken.

Clientspecifieke queries

In GraphQL bepalen clients de structuur van het antwoord door in hun queries de velden te specificeren die ze nodig hebben. Dit betekent dat de client alleen de specifieke data kan opvragen die vereist is, waardoor over-fetching (te veel data ontvangen) en under-fetching (onvoldoende data ontvangen) wordt vermeden.

In GraphQL zou een query om de gegevens van een gebruiker op te halen er zo uitzien:

Voorbeeld van een GraphQL-verzoek en -antwoord. Afbeelding door de auteur.

Queries vs. mutations

Waar queries worden gebruikt om data te lezen, worden mutations gebruikt om data te schrijven of te wijzigen. Mutations in GraphQL zijn analoog aan de operaties POST, PUT en DELETE in REST.

Eén endpoint

In tegenstelling tot REST API’s, die meerdere endpoints kunnen hebben voor verschillende resources, stelt een GraphQL API doorgaans één endpoint beschikbaar. Dit endpoint verwerkt alle queries en mutations, wat het voor clients eenvoudiger maakt om met de API te communiceren.

Sterk getypeerd schema

GraphQL API’s worden gedefinieerd door een schema, een sterk getypeerde definitie van de beschikbare datamodellen en de relaties ertussen. Dit schema fungeert als een contract tussen client en server en zorgt ervoor dat de teruggegeven data overeenkomt met het verzoek van de client en van het verwachte type is.

Introspectie

Het GraphQL-schema is zelfdocumenterend. Clients kunnen de introspectiefunctie gebruiken om het schema zelf te bevragen en de beschikbare types, queries, mutations en subscriptions te ontdekken, wat het verkennen en begrijpen van de API makkelijker maakt.

Realtime data

GraphQL ondersteunt realtime data-updates via subscriptions. Subscriptions stellen clients in staat om updates te ontvangen zodra de data waarin ze geïnteresseerd zijn verandert, wat handig is voor realtime-apps zoals chatapps of live feeds.

Belangrijkste verschillen tussen GraphQL en REST

De onderstaande tabel vat de belangrijkste verschillen tussen GraphQL- en REST-API’s samen.

Zoals met de meeste dingen in het leven, heeft elke oplossing zijn voordelen en nadelen.

Kiezen tussen GraphQL en REST

De keuze tussen REST en GraphQL hangt volledig af van de behoeften van je project. Je hebt waarschijnlijk al een idee op basis van de vorige sectie, maar als vuistregel kun je REST gebruiken wanneer je:

• Eenvoudige datamodellen hebt
• Applicaties bouwt die uitgebreide caching vereisen.
• Teams hebt die vertrouwd zijn met REST-conventies.
• Behoefte hebt aan voorspelbare, gestandaardiseerde responses.

En gebruik GraphQL wanneer je te maken hebt met:

• Complexe datamodellen met geneste relaties.
• Applicaties die flexibele, dynamische queries nodig hebben.
• Snelle iteratie en minder aanpassingen aan de backend.
• Realtime-updates.

REST en GraphQL kunnen ook samen worden gebruikt in hybride oplossingen, zodat je project kan profiteren van eenvoudige, goed gedefinieerde REST-endpoints én van de flexibiliteit van GraphQL voor complexere data-opvraging. In een e-commerceapp kun je bijvoorbeeld REST gebruiken voor authenticatie en gebruikersregistratie om te profiteren van standaard beveiligingspraktijken zoals OAuth, en GraphQL om meer geneste en complexe informatie zoals productdetails, categorieën en gebruikersrecensies op te halen.

Conclusie

Je ziet het: zowel GraphQL als REST hebben hun sterke en zwakke punten en zijn geschikt voor verschillende situaties. De keuze tussen beide moet worden bepaald door de eisen van je project en de complexiteit van je data. 

Dat gezegd hebbende: beide tools zijn echt leuk om mee te werken en kunnen je veel leren over data. Als je de kans hebt, zou ik aanraden om ze allebei eens te proberen!

En als je na het lezen hiervan weet welk hulpmiddel je wilt gebruiken, dan ben je klaar voor de volgende stap! Bekijk onze blogpost Mastering API Design: Essential Strategies for Developing High-Performance APIs om te leren hoe je je eigen API’s ontwerpt.