De VPD Playground gebruiken om GraphQL queries te testen tegen de VPD service.
De VPD Playground is een grafische webinterface waarmee je GraphQL queries kunt schrijven en uitvoeren tegen de VPD service, zonder dat je code hoeft te schrijven of een HTTP-client hoeft op te starten. Ideaal om het schema te verkennen, queries te testen en snel resultaten te bekijken.
De Playground is beschikbaar op de VPD-website:
https://vpd.econnect.euhttps://accp-vpd.econnect.euJe hebt geldige OAuth2-credentials nodig om de Playground te gebruiken. Log in met je client credentials (scope vpd) om een sessie te starten.
De Playground biedt een editor met syntax highlighting en autocomplete voor GraphQL. Je typt je query in het linkerpaneel en ziet het resultaat direct in het rechterpaneel. De belangrijkste mogelijkheden:
Open de Playground, authenticeer met je credentials en voer bijvoorbeeld deze query uit:
{
parties(name: "eConnect", country: "NL", maxResults: 3) {
legalName
partyIds {
type
value
}
locations {
city
}
}
}
De response verschijnt direct in het rechterpaneel. Je ziet de juridische naam, identifiers en vestigingsplaats van de gevonden organisaties.
Aan de rechterkant van de Playground vind je de documentatie-explorer. Klik op een type of veld om de beschikbare subvelden te zien. Dit is de snelste manier om te ontdekken welke data beschikbaar is, zonder de API-documentatie apart te raadplegen.
De explorer toont het volledige party-schema inclusief veldtypes, beschrijvingen en of een veld optioneel is. Gebruik dit als naslagwerk bij het bouwen van je queries.
Test altijd eerst op de acceptatieomgeving (accp-vpd.econnect.eu) voordat je queries in productie draait. Gebruik de maxResults-parameter om het aantal resultaten te beperken tijdens het testen. En maak gebruik van de autocomplete in de editor: het bespaart typewerk en voorkomt fouten in veldnamen.
Nee, de Playground is een grafische webinterface met syntax highlighting en autocomplete. Je typt je GraphQL query in het linkerpaneel en ziet het resultaat direct als JSON in het rechterpaneel. De ingebouwde documentatie-explorer helpt je bij het ontdekken van beschikbare velden en types.
Ja, de Playground is beschikbaar op zowel de productie- als de acceptatieomgeving. De acceptatieomgeving bereik je via accp-vpd.econnect.eu. Test altijd eerst op acceptatie voordat je queries in productie draait. Houd er rekening mee dat de data in acceptatie kan afwijken van productie.
Ja, de Playground heeft een variabelenpaneel waarin je variabelen kunt definiëren. Dit maakt je queries herbruikbaar: in plaats van waarden direct in de query te typen, verwijs je naar variabelen. Dat is vooral handig als je dezelfde querystructuur wilt testen met verschillende zoekparameters.
Wil je de VPD structureel inbouwen in je applicatie? Lees dan hoe je de VPD in je integratie gebruikt.
Open de VPD Playground