Javascript API (nieuwe versie)

Overzicht

Met de Pandectes JavaScript API kun je programmatisch met de toestemmingsbanner werken vanuit het thema of aangepaste scripts van je winkel. Zonder complexe code te schrijven, helpt inzicht in wat de API biedt je te weten wat mogelijk is en wanneer je een ontwikkelaar kunt vragen het voor je te implementeren.
Deze functie is beschikbaar in de New Banner en is toegankelijk via Settings → JavaScript API.

Wat kun je doen met de JavaScript API?

De huidige toestemmingsstatus van de bezoeker lezen

Met de API weet je winkel altijd in realtime waarvoor een bezoeker toestemming heeft gegeven. Je kunt controleren:

• Of een bezoeker analytics-tracking heeft toegestaan (bijv. Google Analytics, Microsoft Clarity)
• Of een bezoeker marketing-cookies heeft toegestaan (bijv. Facebook Pixel, TikTok)
• Of een bezoeker preferences/functionality-cookies heeft toegestaan
• De volledige toestemmingsbeslissing van de bezoeker als één object

Dit is handig wanneer je wilt dat andere delen van je winkel zich anders gedragen afhankelijk van waarmee de bezoeker heeft ingestemd.

Het toestemmingsdialoogvenster beheren

Met de API kun je het toestemmingsdialoogvenster van de banner openen of sluiten vanuit elke actie in je winkel. Bijvoorbeeld een knop in de footer, een link op een pagina met privacybeleid of een aangepaste optie "Cookie settings" in je menu. Dit werkt naast de ingebouwde menulinkfunctie, maar geeft ontwikkelaars meer flexibiliteit om het vanuit elk element op de pagina te activeren.

Toestemming programmatisch instellen of bijwerken

In geavanceerde scenario's kan je winkel de toestemmingsbeslissing van een bezoeker rechtstreeks instellen. Bijvoorbeeld wanneer een bezoeker een toestemmingskeuze maakt via een zelfgebouwde aangepaste interface, of wanneer toestemming via een ander mechanisme wordt verzameld en aan Pandectes moet worden doorgegeven om te worden toegepast.

De taal van de banner wijzigen

Met de API kan de taal van het toestemmingsdialoogvenster dynamisch worden gewijzigd. Als je winkel bezoekers in meerdere talen bedient en hun voorkeur detecteert, kan de banner in de juiste taal worden getoond zonder uitsluitend af te hangen van de standaardtaal van de browser.

Reageren op toestemmingsevents

De API kan je winkel op de hoogte brengen op het moment dat er iets toestemmingsgerelateerds gebeurt, zoals:

• Wanneer de banner volledig is geladen en klaar is
• Wanneer het toestemmingsdialoogvenster door de bezoeker wordt geopend
• Wanneer het toestemmingsdialoogvenster wordt gesloten
• Wanneer de bezoeker zijn toestemmingsvoorkeuren wijzigt of indient

Dit betekent dat je flows kunt bouwen die direct reageren op de keuze van een bezoeker. Bijvoorbeeld een trackingscript laden op het moment dat toestemming wordt gegeven, zonder de pagina te hoeven verversen.

Voor wie is dit bedoeld?

De JavaScript API is bedoeld voor handelaren met een ontwikkelaar of voor wie een aangepaste storefront gebruikt. Je hoeft de API niet te gebruiken of te begrijpen om de banner te laten werken. Die werkt volledig zelfstandig. Als je echter een diepere integratie wilt tussen de toestemmingsbanner en de rest van het gedrag van je winkel, is de API het juiste hulpmiddel.

Aan de slag

Om de API te verkennen en de volledige referentie te zien, ga je in de Pandectes-app naar Settings → JavaScript API. De pagina bevat de volledige lijst van beschikbare eigenschappen, functies en events met beschrijvingen. Als je hulp nodig hebt bij het implementeren van een specifieke toepassing, neem dan gerust contact op met ons supportteam.

Bijgewerkt op: 19/10/2026