> ## 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 (nouvelle version)

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

### Vue d'ensemble
L'API JavaScript de Pandectes vous permet d'interagir avec la bannière de consentement de manière programmatique depuis le thème de votre boutique ou des scripts personnalisés. Sans écrire de code complexe, comprendre ce que l'API propose vous aide à savoir ce qui est possible et quand demander à un développeur de l'implémenter pour vous.
Cette fonctionnalité est disponible sur la **nouvelle bannière** et accessible depuis **Settings → JavaScript API**.

### Que pouvez-vous faire avec l'API JavaScript ?
###### Lire l'état de consentement actuel du visiteur
L'API permet à votre boutique de savoir à tout moment, en temps réel, à quoi un visiteur a consenti. Vous pouvez vérifier :
* Si un visiteur a autorisé le suivi **analytics** (par ex. Google Analytics, Microsoft Clarity)
* Si un visiteur a autorisé les cookies **marketing** (par ex. Facebook Pixel, TikTok)
* Si un visiteur a autorisé les cookies de **préférences/fonctionnalité**
* La décision de consentement complète du visiteur sous la forme d'un seul objet
C'est utile lorsque vous voulez que d'autres parties de votre boutique se comportent différemment selon ce que le visiteur a accepté.

###### Contrôler la boîte de dialogue de consentement
L'API vous permet d'**ouvrir ou de fermer la boîte de dialogue de la bannière de consentement** depuis n'importe quelle action sur votre boutique. Par exemple, un bouton dans le pied de page, un lien dans une page de politique de confidentialité ou une option personnalisée « Cookie settings » dans votre menu. Cela fonctionne en complément de la fonction de lien de menu intégrée, mais offre plus de flexibilité aux développeurs pour la déclencher depuis n'importe quel élément de la page.

###### Définir ou mettre à jour le consentement de façon programmatique
Dans des scénarios avancés, votre boutique peut **définir directement la décision de consentement d'un visiteur.** Par exemple, lorsqu'un visiteur fait un choix de consentement via une interface personnalisée que vous avez créée, ou lorsque le consentement est collecté par un autre mécanisme et doit être transmis à Pandectes pour être appliqué.

###### Changer la langue de la bannière
L'API permet de **changer dynamiquement** la langue de la boîte de dialogue de consentement. Si votre boutique sert des visiteurs dans plusieurs langues et détecte leur préférence, la bannière peut s'afficher dans la bonne langue sans dépendre uniquement de la langue par défaut du navigateur.

###### Réagir aux événements de consentement
L'API peut avertir votre boutique dès qu'un événement lié au consentement se produit, par exemple :
* Lorsque la bannière est entièrement chargée et prête
* Lorsque la boîte de dialogue de consentement est ouverte par le visiteur
* Lorsque la boîte de dialogue de consentement est fermée
* Lorsque le visiteur **modifie ou soumet ses préférences de consentement**
Cela signifie que vous pouvez créer des flux qui réagissent instantanément au choix d'un visiteur. Par exemple, charger un script de suivi dès que le consentement est donné, sans avoir besoin d'actualiser la page.

### À qui s'adresse-t-elle ?
L'API JavaScript est destinée aux **commerçants disposant d'un développeur** ou à ceux qui utilisent une **boutique personnalisée (custom storefront)**. Vous n'avez pas besoin d'utiliser ou de comprendre l'API pour que la bannière fonctionne. Elle fonctionne entièrement seule dès l'installation. Cependant, si vous souhaitez une intégration plus poussée entre la bannière de consentement et le reste du comportement de votre boutique, l'API est le bon outil.

### Pour commencer
Pour explorer l'API et consulter la référence complète, allez dans **Settings → JavaScript API** dans l'application Pandectes. La page inclut la liste complète des propriétés, fonctions et événements disponibles, avec leurs descriptions. Si vous avez besoin d'aide pour implémenter un cas d'usage précis, n'hésitez pas à contacter notre équipe de support.