> ## 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).

# API JavaScript (ancienne version)

|| Cet article s'applique à la **bannière Legacy**. Si vous utilisez la nouvelle bannière (v5+), consultez l'article [API JavaScript (nouvelle version)](https://help.pandectes.io/fr/article/api-javascript-nouvelle-version-1mn975r/).

### Vue d'ensemble
L'API JavaScript de Pandectes permet à votre boutique d'interagir avec la bannière de consentement sans dépendre uniquement du comportement intégré de la bannière. Elle offre aux développeurs un ensemble d'outils pour lire l'état actuel de la bannière et du consentement, déclencher des actions et écouter des événements, le tout depuis le thème de votre boutique ou vos scripts personnalisés. Cette page décrit les fonctionnalités disponibles dans la version **Legacy Banner** de l'API.

### Que pouvez-vous faire avec l'API JavaScript Legacy ?
##### Lire l'état de la bannière et du consentement
L'API expose un ensemble de propriétés en lecture seule qui reflètent à tout moment l'état actuel de la bannière et du consentement du visiteur. Vous pouvez vérifier :
* Si l'API et la bannière sont entièrement chargées et prêtes à l'emploi
* Si la bannière est actuellement visible à l'écran
* Si la bannière s'applique au visiteur actuel (selon les règles de géolocalisation)
* Si la géolocalisation est active et dans quel pays le visiteur est détecté
* Dans quelle langue la bannière est actuellement affichée
* Le statut de consentement du visiteur pour chaque catégorie de cookies : strictement nécessaires, fonctionnalité, performance, ciblage et cookies non classés
* Si le visiteur a cliqué sur **Allow**, **Decline** ou **Dismiss** sur la bannière
Votre boutique dispose ainsi d'un instantané en temps réel de ce que le visiteur a accepté et de la façon dont il a interagi avec la bannière.

##### Contrôler l'affichage de la bannière
L'API vous permet d'afficher ou de masquer la bannière par programmation, plutôt que de dépendre uniquement des règles d'affichage automatiques. Vous pouvez notamment :
* **Afficher la bannière** : forcer l'affichage de la bannière de consentement pour le visiteur
* **Masquer la bannière** : la retirer de la vue, avec la possibilité d'afficher ou de masquer en même temps le bouton de révocation/réouverture
* **Afficher ou masquer le bouton de révocation** : le petit bouton qui permet aux visiteurs de rouvrir la bannière après avoir déjà fait un choix
C'est utile lorsque vous souhaitez déclencher la bannière en réponse à une action précise de l'utilisateur, comme un clic sur un lien « Cookie settings » dans votre pied de page.

##### Ouvrir et fermer la fenêtre des préférences
Au-delà de la bannière principale, l'API vous donne aussi le contrôle de la **fenêtre des préférences de cookies**, le panneau où les visiteurs peuvent accepter ou refuser chaque catégorie de cookies. Vous pouvez :
* Ouvrir directement la fenêtre des préférences
* La fermer par programmation
* Enregistrer les préférences actuelles du visiteur et fermer la fenêtre en une seule action
* Définir l'état des cases à cocher de chaque catégorie dans la fenêtre
* Appliquer des modifications de consentement au niveau des catégories avec différents niveaux de granularité
Cela permet des parcours de consentement entièrement personnalisés, où le panneau des préférences est déclenché ou géré en dehors de la bannière elle-même.

##### Déclencher une révocation du consentement
L'API vous permet de **révoquer par programmation le consentement donné précédemment par un visiteur**. Cela réinitialise son état de consentement et, par défaut, rouvre la bannière pour qu'il puisse faire un nouveau choix. Vous pouvez éventuellement empêcher la bannière de se rouvrir automatiquement si vous souhaitez gérer cette étape vous-même.

##### Forcer une action « leave site »
L'API inclut une méthode pour déclencher la **fonction leave site**, la même action que lorsqu'un visiteur clique sur un bouton leave site de la bannière. C'est utile lorsque vous souhaitez offrir aux visiteurs un moyen explicite de quitter la boutique dans le cadre d'un parcours de confidentialité personnalisé.

##### Écouter les événements de la bannière et du consentement
L'API déclenche des événements à des moments clés du cycle de vie de la bannière, afin que votre boutique puisse réagir en temps réel. Vous pouvez écouter :
* Lorsque l'API Pandectes a été **initialisée** et est prête
* Lorsque la page est **entièrement chargée**
* Lorsque la **localisation** du visiteur a été détectée (utile pour une logique basée sur la géolocalisation)
* Lorsque la **langue** de la bannière a été définie
* Lorsque la bannière **devient visible**
* Lorsque la bannière est **masquée**
* Lorsque le visiteur **clique sur le bouton leave site**
* Lorsque la bannière est **fermée** (après une décision de consentement)
* Lorsqu'une **décision de consentement est prise ou mise à jour**
* Lorsque le visiteur **ouvre le panneau des préférences**
Ces événements permettent aux autres scripts et intégrations de votre boutique de réagir immédiatement aux changements de consentement, par exemple en chargeant un script de suivi dès qu'un visiteur accorde son consentement, sans rechargement de la page.

### À qui s'adresse-t-elle ?
L'API JavaScript est destinée aux **commerçants disposant d'un développeur** ou aux boutiques avec une vitrine personnalisée ou headless. La bannière fonctionne parfaitement seule, sans aucune utilisation de l'API. Celle-ci sert aux scénarios avancés où une intégration plus poussée avec le comportement de votre boutique est nécessaire.

### Pour commencer
Pour consulter la référence complète de l'API, allez dans **Settings > JavaScript API** dans l'application Pandectes. Si vous avez besoin d'aide pour un cas d'usage précis, contactez notre équipe d'assistance.