Aufrufrate
Die API akzeptiert 500 Anfragen pro Minute und Konto. Darüber hinaus antwortet sie mit 429 Too Many Requests und den Headern X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset und Retry-After: Warten Sie die angegebene Zeit, bevor Sie es erneut versuchen. Bündeln Sie bei hohem Volumen: Der Versand einer Kampagne an eine Liste ist ein einziger Aufruf, und die CRM API v3 unterstützt Massenoperationen auf Kontakten.
API-Guthaben
Jedes Konto hat ein Kontingent an API-Guthaben, abgeleitet aus Ihrem E-Mail-Guthaben: ×5 bei Abonnements, identisch bei Einzelkäufen. API-Aufrufe, Webhooks und OAuth werden darauf angerechnet. Die Ereignisse api.limit.low und api.limit.reached warnen Sie vor und beim Erreichen der Grenze (Webhook-Ereignisse).
Anhänge und Größe der Anfragen
- Bis zu 5 Anhänge pro E-Mail, 10 MB pro Datei und 15 MB insgesamt.
- Ausführbare Dateien und Skripte (.exe, .bat, .cmd, .js, .vbs, .msi, .jar, .ps1, .dll …) werden abgelehnt.
- Anhänge werden als Base64 übertragen, was sie in der Anfrage um etwa ein Drittel vergrößert.
- Bleiben Sie für die Zustellbarkeit unter 10 MB pro E-Mail und bevorzugen Sie bei großen Dateien einen Download-Link.
Formate und Authentifizierung
- Email API v2 und SMS: JSON oder XML, wählbar über die URL-Erweiterung (
.json/.xml). - CRM API v3: JSON, Felder in
snake_case(id_sender_email,body_html…). - Authentifizierung: Bearer-Token (30 Tage gültig, erneuerbar), API-Schlüssel oder OAuth 2.0. Alle APIs antworten ausschließlich über HTTPS.
Fehlercodes und Details pro Endpunkt: Entwicklerportal.