API compatible Brevo

Chaque site Inklura expose, à l'adresse https://<domaine-du-site>/api/brevo/v3, une implémentation compatible au niveau du protocole de l'API REST Brevo v3 (ex-Sendinblue) : mêmes chemins, même en-tête api-key, mêmes corps JSON, identifiants entiers, mêmes codes et corps d'erreur ({ "code", "message" }).

Un code, un SDK ou un plugin écrit pour Brevo fonctionne en changeant seulement l'URL de base et la clé. Les e-mails partent par l'infrastructure du site (configuration d'envoi du site, journal des envois, suivi des ouvertures et des clics, traitement des rejets), et non par Brevo.

curl https://<domaine-du-site>/api/brevo/v3/account \
  -H "api-key: xkeysib-…" \
  -H "accept: application/json"

Sans clé, ou avec une clé inconnue ou révoquée, l'API répond 401 avec { "code": "unauthorized", "message": "Key not found" }.

Astuce

Essayez chaque opération depuis l'explorateur interactif : saisissez le domaine de votre site et votre clé, envoyez la requête, copiez l'exemple cURL, Node, PHP ou Python.

Ce qui est couvert

Les 74 opérations des sections suivantes de la spécification Brevo v3 :

Section Brevo Contenu
Transactional emails envoi (modèles, paramètres, versions, pièces jointes, planification), journaux, événements, rapports, modèles, liste de blocage
Contacts contacts, listes, dossiers, attributs, import, export, double opt-in
Senders / Domains expéditeurs, domaines d'envoi et vérification DNS
Webhooks abonnements et livraison réelle des événements transactionnels
Account / Process compte, processus asynchrones (import, export)

Les campagnes, SMS, WhatsApp, CRM, e-commerce et conversations ne sont pas encore disponibles (voir Compatibilité).

Comment ça marche

  • Un compte = un site. Une clé API est rattachée à un locataire et à un site ; toutes les données (contacts, listes, modèles, journaux) sont isolées par site. Les clés ont le même format que celles de Brevo (xkeysib-…), ce qui satisfait les contrôles de format des plugins.
  • Envoi. POST /smtp/email passe par le même pipeline que les autres e-mails du site : expéditeur et relais configurés dans la console, journal des envois, pixel de suivi.
  • Événements. Chaque étape (demande, remise, ouverture, clic, rejet, blocage) alimente /smtp/statistics/* et déclenche vos webhooks au format Brevo.
  • Sécurité. Clés stockées sous forme de hachage, isolation stricte par site, et aucune URL fournie par un appelant (import, pièces jointes, webhooks) ne peut viser une adresse interne.

Pages