Compatibilité
Couverture
Les 74 opérations des sections Account, Contacts, Transactional emails, Senders, Domains, Webhooks et Process de la spécification Brevo v3 sont implémentées. Les chemins sont repris à l'identique de la spécification officielle ; la liste complète est dans l'explorateur et dans la spécification OpenAPI.
Pas encore disponible (la route répond 404 document_not_found) : campagnes e-mail, SMS
(campagnes, transactionnel, modèles), WhatsApp, CRM (entreprises, affaires, tâches, notes,
fichiers), e-commerce, conversations, événements, fidélité, compte maître, utilisateurs,
groupes de consentement, objets personnalisés, flux externes, parsing entrant, paiements.
Différences volontaires
| Sujet | Comportement |
|---|---|
| Expéditeurs | actifs dès leur création (pas de validation par code) ; le site maîtrise déjà son relais |
| Segments | GET /contacts/segments renvoie toujours une liste vide |
| Activité du compte | GET /organization/activities renvoie une liste vide |
/account |
plan fixe de type sendLimit ; relais = relais SMTP du site |
| Statistiques | pas d'événement loadedByProxy ; les envois planifiés ou annulés n'apparaissent pas dans /smtp/emails |
| Domaines | authenticate vérifie réellement les enregistrements DNS (TXT brevo-code, DKIM, DMARC) |
Erreurs
Même format que Brevo :
{ "code": "invalid_parameter", "message": "email is not valid in to" }
| Statut | code |
Exemple |
|---|---|---|
| 400 | invalid_parameter, missing_parameter, duplicate_parameter, out_of_range, bad_request |
e-mail invalide, champ requis absent, doublon, limit trop grand, JSON illisible |
| 401 | unauthorized |
clé absente, inconnue ou révoquée |
| 404 | document_not_found |
ressource ou route inconnue |
| 405 | method_not_allowed |
méthode non prise en charge sur ce chemin (l'en-tête Allow liste les méthodes acceptées) |
| 500 | internal_error |
erreur inattendue côté plateforme |
La clé est vérifiée avant la route : sans clé valide, une route inconnue répond 401 et non 404.
Limites
| Élément | Limite |
|---|---|
Destinataires to |
99 par e-mail |
messageVersions |
1 000 par requête |
| Planification | 72 h |
POST /contacts/batch |
100 contacts |
| Ajout / retrait de liste | 150 contacts par requête |
GET /contacts |
limit ≤ 1000 |
| Idempotence | 24 h |
L'idempotence de POST /smtp/email passe, comme chez Brevo, par la clé idempotencyKey de l'objet
headers du corps. Un second envoi avec la même clé dans les 24 h n'envoie rien et renvoie les
messageId du premier.