GraphQL: sneller de juiste data uit je systemen halen
Je webshop, ERP-systeem en CRM bevatten allemaal waardevolle gegevens. Maar hoe krijg je daar snel een compleet beeld van, zonder informatie uit verschillende systemen zelf bij elkaar te puzzelen? Kevin Ronkes, data-engineer bij UCaaS, legt uit hoe GraphQL helpt om gericht gegevens op te vragen en hoe dat in de praktijk werkt.
Wat is GraphQL?
GraphQL is een querytaal voor API's. Je beschrijft welke gegevens je nodig hebt, waarna de API die gegevens volgens een afgesproken structuur teruggeeft. Zo kan een applicatie bijvoorbeeld in één aanvraag de naam van een klant, de laatste drie orders en de producten per order opvragen.
Bij een API die per onderdeel een vast antwoord geeft, kan het nodig zijn om meerdere verzoeken te doen: eerst voor de klant, daarna voor de orders en vervolgens voor de producten. Hoe dat precies werkt, hangt af van de API. GraphQL biedt een andere manier om de vraag op te bouwen: je vraagt de gewenste gegevens en relaties gericht op, in plaats van standaard een grote hoeveelheid velden te ontvangen.
Van losse gegevens naar een compleet beeld
Een klant van UCaaS wilde meer inzicht in zijn verkoopdata. Met de API waarmee de klant werkte, werden klantgegevens, orders en productinformatie afzonderlijk opgehaald. Daarna moesten de gegevens nog aan elkaar worden gekoppeld om de samenhang te zien.
Voor deze klant bouwde UCaaS een GraphQL-endpoint. De gebruiker kan daarin vanuit een verkooporder doorklikken naar de klant, de klanthistorie en de producten op de order. De benodigde relaties zijn in de API vastgelegd. Daardoor kan de klant de informatie gericht opvragen, zonder de losse puzzelstukjes zelf bij elkaar te leggen.
Wat GraphQL wel en niet doet
GraphQL is geen database en verbindt niet vanzelf systemen met elkaar. Een GraphQL-API heeft een schema nodig dat beschrijft welke gegevens en relaties beschikbaar zijn. Ook moet de achterliggende logica weten waar die informatie vandaan komt en hoe die wordt opgehaald. Dat kan bijvoorbeeld uit een database, een bestaande API of meerdere bronnen.
Als die basis goed is ingericht, kan GraphQL het voor gebruikers en applicaties eenvoudiger maken om samenhangende gegevens op te vragen. Welke gegevens beschikbaar zijn en hoe actueel ze zijn, hangt af van de bronnen en de inrichting van de API.
Waarom UCaaS dit snel kan leveren
UCaaS kent de datastructuren van klanten en weet hoe gegevens en processen samenhangen. Dat helpt bij het bepalen van de juiste relaties en het opzetten van een endpoint dat aansluit op de informatiebehoefte.
Ook het genereren van endpoints en documentatie is grotendeels geautomatiseerd. Daardoor kunnen klanten sneller met de API aan de slag en zien ze in de documentatie welke gegevens beschikbaar zijn en hoe ze die kunnen opvragen.
GraphQL en KQL hebben een ander doel
GraphQL is niet de enige querytaal die UCaaS gebruikt. In de MCP-oplossing wordt bijvoorbeeld KQL gebruikt om performancegegevens uit Application Insights op te halen. KQL is gericht op het doorzoeken van log- en telemetriegegevens; GraphQL wordt gebruikt om gegevens via een API op te vragen.
Welke taal past, hangt dus af van de bron en de vraag. Het doel is steeds om relevante informatie toegankelijk te maken voor de mensen en toepassingen die ermee werken. Dat sluit aan op bredere datakoppelingen tussen bedrijfssystemen.
Vijf dingen om mee te nemen
- Met GraphQL beschrijf je welke gegevens en velden je via een API wilt opvragen.
- Een GraphQL-verzoek kan samenhangende gegevens, zoals klant, orders en producten, in één aanvraag combineren.
- De relaties moeten vooraf in het schema en de achterliggende logica van de API zijn ingericht.
- GraphQL vervangt geen database of datakoppeling; het biedt een manier om gegevens via een API op te vragen.
- KQL en GraphQL hebben verschillende toepassingen. De passende querytaal hangt af van de databron en de informatie die je zoekt.
Benieuwd welke data je kunt ontsluiten?
We denken graag mee over hoe je gegevens uit jouw systemen toegankelijk maakt. Neem contact op via 0546-200021, mail naar info@ucaas.nl of plan direct een meeting in.
