# Premiers pas L'API Commanders Act Consent est utilisée pour interagir avec Commanders Act Consent via JavaScript. Elle offre actuellement uniquement des méthodes pour recevoir et mettre à jour le consentement, mais elle sera améliorée avec des méthodes supplémentaires à l'avenir. ## Stub d'API Il est nécessaire d'installer un stub JavaScript avant que l'une des méthodes de l'OnSite API puisse être utilisée. Le stub sert à mettre en mémoire tampon toutes les méthodes dans un tableau JavaScript jusqu'à ce que le JavaScript de la bannière Commanders Act consent soit chargé et prêt à traiter les méthodes. Cela permet d'utiliser l'OnSite API avant que la bannière Commanders Act Consent (fichier JavaScript) ne soit chargée. ```javascript window.caReady = window.caReady || []; window.cact = function() { window.caReady.push(arguments); }; ``` `window.caReady` est un tableau JavaScript qui met en buffer les interactions avec l'API. `window.cact` est une fonction JavaScript utilisée pour interagir avec l'OnSite API. {% hint style="success" %} Si vous travaillez dans une grande équipe et n'êtes pas sûr que le stub ait déjà été installé, il est acceptable d'installer le stub JavaScript plusieurs fois. {% endhint %} ## Méthodes Après l'installation du stub, il est alors possible d'utiliser n'importe laquelle des méthodes de l'OnSite API via le `window.cact` fonction. {% hint style="info" %} Les méthodes disponibles sont listées dans la documentation sous **ONSITE API**. {% endhint %} Chaque méthode suit une signature stricte : ```javascript cact(command, [options,] [callback]) ``` | Argument | Descriptions | Obligatoire | | ---------- | ------------------------------------------------------------------------------------------------------------------------ | ----------- | | `command` | Un identifiant sous forme de chaîne utilisé pour sélectionner la méthode souhaitée. | Obligatoire | | `options` | Un objet JavaScript qui inclut les données passées à la méthode. | Optionnel | | `callback` | Une fonction de rappel JavaScript qui est utilisée pour recevoir des informations ou des événements depuis l'OnSite API. | Optionnel | Vous trouverez ci‑dessous un exemple de méthode utilisée pour recevoir le statut de consentement Commanders Act avec l'OnSite API. Cet exemple fournit uniquement un callback pour recevoir le consentement sans fournir d'options. ```javascript cact('consent.get', function (result) { if (result.consent.status === "all-on") { // Consentement disponible pour toutes les catégories. } }); ``` {% hint style="warning" %} Les méthodes de l'OnSite API sont appelées de manière asynchrone. Dans le cas où, par ex. vous auriez besoin d'informations de manière synchrone dans le `` du document, il est recommandé de mettre en cache et récupérer le résultat de l'API dans `localStorage`. {% endhint %}