Dans Sarbacane Campaigns, l'API REST permet aux développeurs de piloter vos listes de contacts et vos listes noires (désinscrits, NPAI, plaintes), et de récupérer les statistiques de vos campagnes email et SMS sans se connecter à l'application. Elle fonctionne par requêtes HTTP standard : GET pour récupérer des données, POST pour en ajouter, PUT pour en modifier et DELETE pour en supprimer. Chaque outil se connecte avec une clé API, créée dans Paramètres › API & webhooks.
Un abonnement Sarbacane Campaigns Premium ou supérieur.
Être propriétaire ou administrateur du compte, ou utilisateur avec ce droit dans Autorisations.
Dans le menu de gauche de Sarbacane Campaigns, cliquez sur Paramètres, puis sur API & webhooks.
Dans l'onglet API, vérifiez que l'interrupteur L'API Sarbacane est activée est activé.
Sur la ligne Ajouter une nouvelle clé API, cliquez sur Créer.
Dans Description, saisissez le nom de l'outil qui utilisera la clé.
Pour limiter l'usage de la clé à certaines adresses IP, cliquez sur Ajouter une IP et saisissez l'adresse. Cette étape est facultative.
Cliquez sur Enregistrer.
Note : la documentation complète (authentification avec l'Account ID et la clé, liste des requêtes, exemples en cURL) se trouve sur https://developers.sarbacane.com, accessible aussi par le bouton Documentation API. Les exemples se transposent dans la plupart des langages : PHP, Node.js, Ruby, Python, Java, Go ou C#.
Bonne pratique : créez une clé par outil, nommée d'après l'outil. Vous pourrez ainsi en supprimer une sans couper les autres.
La clé apparaît dans la liste, avec sa description. L'Account ID, affiché en haut de l'onglet, et la documentation (Documentation API) complètent les informations dont votre développeur a besoin.
Créez une nouvelle clé, remplacez-la dans vos outils, puis supprimez l'ancienne (menu •••, Supprimer).
Si la clé est limitée à certaines adresses IP, vérifiez que celle de votre outil figure dans la liste (menu •••, Éditer).
