Cadence des appels
L'API accepte 500 requêtes par minute et par compte. Au-delà, elle répond 429 Too Many Requests avec les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset et Retry-After : attendez le délai indiqué avant de réessayer. Pour un gros volume, groupez : un envoi de campagne à une liste vaut un seul appel, et l'API CRM v3 accepte les opérations par lot sur les contacts.
Crédits API
Chaque compte dispose d'un quota de crédits API, calculé à partir de vos crédits email : ×5 pour les abonnements, à l'identique pour les achats à l'acte. Les appels API, les webhooks et OAuth y sont décomptés. Les événements api.limit.low et api.limit.reached vous alertent avant et au moment d'atteindre la limite (événements webhook).
Pièces jointes et taille des requêtes
- Jusqu'à 5 pièces jointes par e-mail, 10 Mo par fichier et 15 Mo au total.
- Les fichiers exécutables et scripts (.exe, .bat, .cmd, .js, .vbs, .msi, .jar, .ps1, .dll…) sont refusés.
- Les pièces jointes sont transmises en base64, ce qui augmente leur taille d'environ un tiers dans la requête.
- Pour la délivrabilité, restez sous 10 Mo par email et préférez un lien de téléchargement pour les gros fichiers.
Formats et authentification
- API Email v2 et SMS : JSON ou XML, au choix par l'extension de l'URL (
.json/.xml). - API CRM v3 : JSON, champs en
snake_case(id_sender_email,body_html…). - Authentification : token Bearer (valable 30 jours, renouvelable), clé API ou OAuth 2.0. Toutes les API répondent en HTTPS uniquement.
Codes d'erreur et détails par endpoint : portail développeurs.