GraphQL vs. REST API

Heb je ooit aan een webapp-ontwikkelingsproject gewerkt? Zo ja, dan ben je misschien al de term "GraphQL" tegengekomen. Maar wat betekent het precies? Wordt het gebruikt in server-side of client-side configuraties? Bovendien, wanneer is GraphQL-integratie te verkiezen boven andere alternatieven? In dit artikel zullen we je door deze vragen begeleiden.

Als communicatiekanaal voor gegevensoverdracht tussen softwarecomponenten via het internet, spelen API's een onmisbare rol in moderne webservicearchitecturen, net als zuurstof. API-technologieën zoals SOAP (een berichtenprotocol voor webservices), REST (architecturale stijl) en GraphQL (een querytaal en tool) vergemakkelijken softwareontwikkeling door integratie en gegevensuitwisseling tussen verschillende diensten te ondersteunen, waardoor ontwikkeling handiger en flexibeler wordt.

Ondanks de talrijke soorten API's, hebben de debatten in de afgelopen jaren zich voornamelijk gericht op twee hoofdparadigma's: REST (representational state transfer) en GraphQL. Beide bieden een reeks voordelen en worden wereldwijd gebruikt in webprojecten. Ze verschillen echter aanzienlijk in de manier waarop ze gegevenscommunicatie beheren.

Wat is REST API?#

REST is een gestructureerde architecturale stijl die in het begin van de 21e eeuw is ontwikkeld voor het bouwen van hypermedia-toepassingen over netwerken, ontworpen om een stateloos en cacheerbaar communicatieprotocol tussen clients en servers aan te nemen. De REST API (ook bekend als RESTful API) is de drijvende kracht achter de REST-architectuur.

REST API gebruikt Uniform Resource Identifiers (URI's) om resources aan te pakken. REST API werkt door middel van verschillende eindpunten die CRUD (create, read, update en delete) operaties op netwerkbronnen uitvoeren. Het vertrouwt op vooraf gedefinieerde gegevensformaten (bekend als mediatypes of MIME-typen) om de vorm en grootte van de bronnen te bepalen die ze aan clients verstrekken. De meest voorkomende formaten zijn JSON en XML (soms HTML of platte tekst).

Nadat de client een resource opvraagt, verwerkt de server de query en retourneert alle gegevens met betrekking tot die resource. Het antwoord bevat HTTP-responscodes zoals "200 OK" (voor een succesvolle REST-aanvraag) en "404 Not Found" (voor een niet-bestaande resource).

Hoe werkt REST API?#

REST API's vertrouwen op vooraf gedefinieerde eindpunten die resources blootstellen via HTTP. Elk eindpunt vertegenwoordigt een resource, zoals gebruikers of berichten, en wordt geïdentificeerd door een unieke URL. REST-operaties zijn gekoppeld aan standaard HTTP-methoden zoals GET, POST, PUT en DELETE, die overeenkomen met het ophalen, creëren, bijwerken en verwijderen van gegevens.

Een verzoek naar GET /users haalt bijvoorbeeld een volledige lijst met gebruikers op, terwijl GET /users/123 de details ophaalt van een specifieke gebruiker die wordt geïdentificeerd door hun ID. Als je ook gerelateerde gegevens wilt openen, zoals de organisaties van de gebruiker en de rollen binnen de organisatie, zou je extra oproepen moeten doen naar GET /users/123/organizations.

REST volgt een resource-centrische benadering, gericht op het openen en manipuleren van afzonderlijke resources.

Wat is GraphQL?#

GraphQL is zowel een API-type (of querytaal) als een runtime-engine voor het beantwoorden van die queries. Het biedt een vereenvoudigde API en is bijzonder geschikt voor mobiele applicaties en de implementatie van complexe architecturen die specifieke subsets van gegevens vereisen.

Met GraphQL kunnen ontwikkelaars specificeren welke gegevens ze uit de API willen ophalen. Het stelt ontwikkelaars ook in staat om gegevens op aanvraag op te halen in plaats van alles in één keer op te halen, past veranderingen onmiddellijk toe en integreert gegevensbronnen van derden in de applicatie.

Applicaties kunnen GraphQL-queries gebruiken om GraphQL-diensten aan te roepen. Deze queries retourneren de exacte gegevens elementen die door de client worden opgevraagd. Dit bespaart meerdere API-oproepen, netwerkbandbreedte en nabewerking. Het is een zeer efficiënte oplossing voor gegevensgerichte API's die zich dicht bij consument apparaten, zoals tablets en mobiele telefoons, bevinden.

Hoe werkt GraphQL?#

GraphQL daarentegen neemt een query-gebaseerde benadering aan. In plaats van vooraf gedefinieerde eindpunten, stelt GraphQL één enkel eindpunt bloot dat gestructureerde queries accepteert. Clients specificeren precies welke gegevens ze nodig hebben met behulp van een querytaal.

Daarom moet een volledige GraphQL-implementatie uit twee delen bestaan: schema's en resolvers.

GraphQL-schema#

Schema's definiëren de typen gegevens en hun velden die kunnen worden opgevraagd via GraphQL-queries:

Stel bijvoorbeeld dat je het volgende schema hebt:

Een client kan de naam, e-mail, organisaties en rollen van een gebruiker opvragen met de volgende query:

Deze query haalt niet alleen de opgevraagde velden (e-mail en organisaties) op, maar haalt ook de gerelateerde gegevens (rollen) op in een enkele aanvraag.

GraphQL-resolver#

Een GraphQL-resolver is een sleutel component in een GraphQL-server die bepaalt hoe de door een client opgevraagde gegevens in een GraphQL-query moeten worden opgehaald of berekend. Wanneer een client een query verzendt, wordt elk veld in de query gekoppeld aan een resolver, die de logica bevat om de gegevens voor dat veld op te halen of te berekenen.

In het bovenstaande voorbeeld zouden de resolvers voor het schema er als volgt uitzien:

Er zijn twee soorten resolvers: root resolvers en field resolvers.

• Root Resolvers: Behandelen toplevel velden in het schema, zoals Query, Mutation en Subscription.
• Field Resolvers: Behandelen individuele velden binnen een type, vaak voor geneste queries. Als er geen specifieke resolver voor een veld wordt verstrekt, gebruikt GraphQL de standaard resolver, die de waarde retourneert van het bovenliggende object met de overeenkomende veldnaam.

GraphQL-operaties#

GraphQL ondersteunt drie soorten operaties: queries, mutaties en abonnementen.

• Query: Gebruikt om gegevens te LEZEN.
• Mutation: Gebruikt om gegevens te SCHRIJVEN, inclusief operaties om gegevens toe te voegen, te wijzigen en te verwijderen.
• Subscription: Gebruikt om een blijvende verbinding voor gegevens aan te vragen, waardoor de client de soorten gebeurtenissen kan verklaren waarin hij geïnteresseerd is en de gegevens die moeten worden geretourneerd.

Verschillen tussen GraphQL en REST API's#

GraphQL en REST API's zijn hulpmiddelen voor het uitwisselen van gegevens tussen verschillende webdiensten, maar vanwege hun verschillende benaderingen van het oplossen van problemen zijn hier de belangrijkste verschillen tussen hen:

Gegevens ophalen#

REST API haalt vaak gegevens te veel of te weinig op omdat eindpunten vaste antwoorden retourneren. GraphQL lost dit op door clients precies te laten opvragen wat ze nodig hebben, waardoor onnodige gegevensoverdracht wordt verminderd. Dit maakt GraphQL ideaal voor toepassingen met complexe databehoeften, zoals mobiele of omgevingen met lage bandbreedte.

Stel je het bovenstaande voorbeeld voor waarin je de statische gegevens van een gebruiker, organisaties en organisatie rollen die aan de gebruiker zijn toegewezen, moet ophalen. Met REST API zou je meerdere aanvragen naar verschillende eindpunten moeten doen om alle gegevens te krijgen. Met GraphQL kun je echter alle gegevens in één enkele aanvraag ophalen.

Flexibiliteit#

De eindpunt-gebaseerde structuur van REST is eenvoudig en werkt goed voor eenvoudige toepassingen met standaard CRUD-operaties. Dit komt omdat REST API's zijn ontworpen om resource-gericht te zijn, waarbij elk eindpunt een specifieke resource vertegenwoordigt. De grootste beperking van deze benadering is dat het niet toestaat om snel te itereren en veranderingen in klantvereisten op te vangen. Bij elke verandering die aan de client wordt aangebracht, moet de server worden bijgewerkt om aan de nieuwe vereisten te voldoen, hetzij door nieuwe eindpunten toe te voegen of bestaande te updaten. Dit eindigt vaak in veel overbodige eindpunten en complexe API-versiebeheer.

GraphQL daarentegen is flexibeler en stelt clients in staat om alleen de gegevens aan te vragen die ze nodig hebben. Deze flexibiliteit is bijzonder handig wanneer klantvereisten vaak veranderen, omdat het de noodzaak elimineert om de server-side API-implementatie te wijzigen. Clients kunnen nieuwe velden of geneste gegevens aanvragen zonder wijzigingen aan de server te vereisen.

Caching#

Hoewel GraphQL efficiënter en flexibeler is in termen van gegevensverzameling, heeft het ook enkele nadelen. Eén van de belangrijkste problemen is caching.

De REST API heeft een volwassen ecosysteem. Door zijn stateloze en gestandaardiseerde aard is het gemakkelijk om antwoorden te cachen op zowel server- als clientniveau. Dit kan het aantal verzoeken aan de server aanzienlijk verminderen en de prestaties verbeteren.

Vanwege zijn flexibiliteit zijn veel van de cachingtechnologieën die beschikbaar zijn voor de REST API echter niet toepasbaar op GraphQL. Het is noodzakelijk om caching aan de clientzijde te beheren, gebaseerd op specifieke gebruiksscenario's, wat extra werkdruk voor clientontwikkeling met zich meebrengt.

Voors en Tegens#

Conclusie#

Hoewel GraphQL de laatste jaren als nieuwkomer sterk in opkomst is, behoudt de REST API nog steeds een grote betekenis vanwege zijn atomische ontwerp en strengheid.

REST en GraphQL voldoen aan verschillende behoeften en excelleren in verschillende scenario's. De eenvoud van REST maakt het een perfecte keuze voor eenvoudige applicaties en microservices. GraphQL blinkt uit in scenario's waarin flexibele en efficiënte gegevensverzameling vereist is, vooral in applicaties met diverse clients of complexe relaties tussen gegevens. De keuze tussen de twee hangt af van de specifieke vereisten van je project, de expertise van je team en de behoeften op lange termijn van schaalbaarheid.