> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pandectes.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Javascript API (oude versie)

|| Dit artikel is van toepassing op de **Legacy Banner**. Als je de nieuwe banner (v5+) gebruikt, raadpleeg dan het artikel [JavaScript API (New Version)](https://help.pandectes.io/nl/article/javascript-api-nieuwe-versie-3ad16r/).

### Overzicht
Met de Pandectes JavaScript API kan je winkel met de toestemmingsbanner werken zonder uitsluitend af te hangen van het ingebouwde gedrag van de banner. Het geeft ontwikkelaars een set tools om de huidige status van de banner en toestemming te lezen, acties te activeren en naar events te luisteren, allemaal vanuit het thema of aangepaste scripts van je winkel. Deze pagina beschrijft de mogelijkheden die beschikbaar zijn in de **Legacy Banner**-versie van de API.

### Wat kun je doen met de Legacy JavaScript API?
##### De status van de banner en toestemming lezen
De API biedt een reeks alleen-lezen eigenschappen die op elk moment de huidige status van de banner en de toestemming van de bezoeker weergeven. Je kunt controleren:
* Of de API en banner volledig zijn geladen en klaar zijn voor gebruik
* Of de banner momenteel zichtbaar is op het scherm
* Of de banner überhaupt van toepassing is op de huidige bezoeker (op basis van geolocatieregels)
* Of geolocatie actief is en in welk land de bezoeker wordt gedetecteerd
* In welke taal de banner momenteel wordt weergegeven
* De toestemmingsstatus van de bezoeker voor elke afzonderlijke cookiecategorie: strikt noodzakelijk, functionaliteit, prestaties, targeting en niet-geclassificeerde cookies
* Of de bezoeker op de banner op **Allow**, **Decline** of **Dismiss** heeft geklikt
Hierdoor heeft je winkel een realtime momentopname van precies waarmee een bezoeker heeft ingestemd en hoe hij met de banner is omgegaan.

##### De weergave van de banner beheren
Met de API kun je de banner programmatisch tonen of verbergen, in plaats van alleen te vertrouwen op de automatische weergaveregels. Concreet kun je:
* **De banner tonen** — de toestemmingsbanner afdwingen voor de bezoeker
* **De banner verbergen** — uit het zicht halen, met de optie om tegelijkertijd ook de revoke/reopen-knop te tonen of te verbergen
* **De revoke-knop tonen of verbergen** — de kleine knop waarmee bezoekers de banner opnieuw kunnen openen nadat ze al een keuze hebben gemaakt
Dit is handig wanneer je de banner wilt activeren als reactie op een specifieke gebruikersactie, zoals het klikken op een link "Cookie settings" in je footer.

##### Het voorkeurenpopup openen en sluiten
Naast de hoofdbanner geeft de API je ook controle over het **popup voor cookievoorkeuren**, het paneel waar bezoekers afzonderlijke cookiecategorieën kunnen accepteren of weigeren. Je kunt:
* Het voorkeurenpopup rechtstreeks openen
* Het programmatisch sluiten
* De huidige voorkeuren van de bezoeker opslaan en het popup in één actie sluiten
* De status van afzonderlijke categorievakjes in het popup instellen
* Toestemmingswijzigingen op categorieniveau toepassen met verschillende gradaties van detail
Dit maakt volledig aangepaste toestemmingsflows mogelijk waarbij het voorkeurenpaneel buiten de banner zelf wordt geactiveerd of beheerd.

##### Een toestemmingsintrekking activeren
Met de API kun je **eerder gegeven toestemming van een bezoeker** programmatisch **intrekken**. Dit reset hun toestemmingsstatus en opent standaard de banner opnieuw zodat ze een nieuwe keuze kunnen maken. Optioneel kan worden voorkomen dat de banner automatisch opnieuw opent als je die stap zelf wilt afhandelen.

##### Een "leave site"-actie afdwingen
De API bevat een methode om de **leave site-functionaliteit** te activeren, dezelfde actie die plaatsvindt wanneer een bezoeker op een leave-site-knop op de banner klikt. Dit is handig in scenario's waarin je bezoekers een expliciete manier wilt bieden om de winkel te verlaten als onderdeel van een aangepaste privacyflow.

##### Luisteren naar banner- en toestemmingsevents
De API vuurt events af op belangrijke momenten in de levenscyclus van de banner, zodat je winkel in realtime kan reageren. Je kunt luisteren naar:
* Wanneer de Pandectes API is **geïnitialiseerd** en klaar is
* Wanneer de pagina **volledig is geladen**
* Wanneer de **locatie** van de bezoeker is gedetecteerd (handig voor logica op basis van geolocatie)
* Wanneer de **taal** van de banner is ingesteld
* Wanneer de banner **zichtbaar wordt**
* Wanneer de banner wordt **verborgen**
* Wanneer de bezoeker **op de leave-site-knop klikt**
* Wanneer de banner wordt **gesloten** (na een toestemmingsbeslissing)
* Wanneer een **toestemmingsbeslissing wordt genomen of bijgewerkt**
* Wanneer de bezoeker **het voorkeurenpaneel opent**
Met deze events kunnen andere scripts en integraties in je winkel direct reageren op toestemmingswijzigingen, bijvoorbeeld door een trackingscript te laden op het moment dat een bezoeker toestemming geeft, zonder dat de pagina opnieuw hoeft te worden geladen.

### Voor wie is dit bedoeld?
De JavaScript API is bedoeld voor **handelaren met een ontwikkelaar** of voor winkels met een aangepaste of headless storefront. De banner werkt volledig zelfstandig zonder gebruik van de API — dit is voor geavanceerde scenario's waarin een nauwere integratie met het gedrag van je winkel nodig is.

### Aan de slag
Om de volledige API-referentie te bekijken, ga je in de Pandectes-app naar **Settings → JavaScript API**. Als je hulp nodig hebt bij een specifieke toepassing, neem dan contact op met ons supportteam.