API JavaScript (nouvelle version)

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.

Mis à jour le : 02/10/2026