Zum Inhalt springen
Doku

Referenz

Wie Emailit den Versand pro Workspace begrenzt, die Rate-Limit-Header bei jeder Sendung, wie eine 429-Antwort aussieht, weitere Limits einzelner Endpunkte und wie Sie mit Backoff wiederholen.

Aktualisiert am 19. Okt. 2026

Emailit begrenzt, wie schnell und wie viel ein Workspace senden kann, nicht wie viele API-Aufrufe Sie machen. Diese Seite erklärt die Versandlimits, die Header, die sie melden, die wenigen Endpunkte mit eigenen Limits und wie Sie mit Backoff reagieren, wenn Sie 429 erhalten.

Versandlimits

Jeder Workspace hat zwei Versandlimits. Sie beginnen bei diesen Werten:

Limit Startwert Zeitfenster
Pro Sekunde 2 E-Mails Gleitendes Fenster von einer Sekunde
Pro Tag 100 E-Mails bei Pay as you go bis zum ersten Credit-Kauf, danach 5.000. 5.000 bei Pro und Business. Kalendertag in UTC, wird um 00:00 UTC zurückgesetzt

So gelten die Limits:

  • Pro Workspace. Alle API-Schlüssel und das SMTP-Relay teilen sich dieselben Zähler. Der Versand per SMTP verbraucht dasselbe Kontingent wie die API.
  • Nach Empfängern gezählt. Jede eindeutige Adresse in to, cc und bcc zählt als eine E-Mail. Eine Anfrage mit drei Empfängern zählt als drei.
  • Nur Sendungen zählen. Die Limits gelten für E-Mail senden und E-Mail weiterleiten. Das Lesen von Daten und das Verwalten von Ressourcen zählen nicht dazu.
  • Die ganze Anfrage muss passen. Eine Sendung wird nur angenommen, wenn alle ihre Empfänger in das passen, was vom heutigen Limit übrig ist; andernfalls erhält sie 429, und es wird nichts gesendet. Ihre Empfänger werden zu den Zählern addiert, nachdem die E-Mail gespeichert wurde.

Die aktuellen Limits und die heutige Nutzung sehen Sie auf der Startseite Dashboard in der Karte Sending Limits.

Rate-Limit-Header

Antworten der Endpunkte zum Senden und Weiterleiten enthalten diese Header:

Header Beschreibung
ratelimit-limit E-Mails, die der Workspace pro Sekunde senden kann.
ratelimit-remaining Verbleibende E-Mails im aktuellen Fenster von einer Sekunde.
ratelimit-reset Sekunden, bis das Sekundenfenster zurückgesetzt wird.
ratelimit-daily-limit E-Mails, die der Workspace pro Tag senden kann.
ratelimit-daily-remaining Heute noch verbleibende E-Mails.
ratelimit-daily-reset Sekunden, bis das Tageslimit um 00:00 UTC zurückgesetzt wird.
retry-after Sekunden, die Sie vor einer Wiederholung warten sollten. Nur bei 429-Antworten.
HTTP
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
ratelimit-limit: 2
ratelimit-remaining: 1
ratelimit-reset: 1
ratelimit-daily-limit: 5000
ratelimit-daily-remaining: 4812
ratelimit-daily-reset: 52113

Wenn Sie ein Limit erreichen

Eine Sendung über dem Limit gibt 429 Too Many Requests mit dem Header retry-after zurück. Der Body nennt das erreichte Limit:

JSON
{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Maximum 2 messages per second allowed.",
  "limit": 2,
  "current": 2,
  "retry_after": 1
}
Feld Beschreibung
error Rate limit exceeded für das Limit pro Sekunde, Daily limit exceeded für das Tageslimit.
limit Das erreichte Limit.
current Wie viele E-Mails im Zeitfenster bereits gezählt wurden.
retry_after Wartezeit in Sekunden. 1 beim Limit pro Sekunde, beim Tageslimit die Sekunden bis 00:00 UTC.

Wird eine Anfrage abgelehnt, wird nichts gesendet und es werden keine Credits verbraucht. Wiederholen Sie Anfragen, die wegen des Limits pro Sekunde abgelehnt wurden, nach kurzer Wartezeit. Bei Ablehnungen wegen des Tageslimits stellen Sie die E-Mail in eine Warteschlange und senden sie nach dem Zurücksetzen, oder Sie beantragen ein höheres Limit.

Weitere Limits

Einige Endpunkte haben eigene Limits:

Endpunkt Limit Gezählt pro
POST /emails/{id}/forward 3 pro Stunde Workspace
POST /webhooks/{id}/test 5 pro Minute IP-Adresse
Gehostete An- und Abmeldelinks (/subscribe/{token}, /unsubscribe/{token}) 30 pro Minute IP-Adresse
Öffentliche Formular-Endpunkte: Formular laden (GET /forms/{token}) 60 pro Minute IP-Adresse
Öffentliche Formular-Endpunkte: Formular absenden (POST /forms/{token}/submit) 30 pro Minute IP-Adresse
Events des Tracking-Skripts (https://api.emailit.com/public/v1/track/{key}) 600 Anfragen pro Minute, mit je bis zu 50 Events Tracking-Schlüssel und IP-Adresse

Weiterleitungen zählen außerdem zu den oben genannten Versandlimits. Über dem Limit für Weiterleitungen gibt die API 429 mit dem Header retry-after zurück:

JSON
{
  "error": "too_many_requests",
  "message": "Forwarding is limited to 3 emails per hour for this workspace. Try again later."
}

Diese Limits sind fest und ändern sich nicht mit Ihrem Tarif oder Ihren Versandlimits.

Alle anderen Endpunkte

Endpunkte, die Daten lesen oder Ressourcen verwalten, haben kein festes Limit pro Endpunkt. Halten Sie Ihre Nutzung in einem vernünftigen Rahmen: Verwenden Sie einen kleinen Pool gleichzeitiger Anfragen statt Tausender paralleler Anfragen, cachen Sie Daten, die sich selten ändern, und verwenden Sie Webhooks, statt den E-Mail-Status regelmäßig abzufragen.

Limits erhöhen

  • Pay as you go. Der erste Credit-Kauf oder eine AppSumo-Lizenz erhöht 100 E-Mails pro Tag sofort auf 5.000.
  • Pro und Business. Das Tageslimit steigt automatisch und schrittweise, während Sie senden, solange Ihre Bounce- und Beschwerderaten niedrig bleiben. Siehe Automatische Erhöhungen.
  • Erhöhung beantragen. Wählen Sie auf der Startseite Dashboard in der Karte Sending Limits die Schaltfläche Request increase, legen Sie fest, wie viel mehr Sie brauchen (+5.000, +10.000 oder +15.000 pro Tag oder mehr), optional ein Limit pro Sekunde, und beschreiben Sie, was Sie senden und woher Ihre Empfänger stammen. Sie können alle 7 Tage eine Anfrage senden, und das Team antwortet in der Regel innerhalb von 24 Stunden.

Alle Tariflimits finden Sie unter Limits.

Mit Backoff wiederholen

Wiederholen Sie Anfragen mit den Antworten 429, 409 (Idempotenzschlüssel in Bearbeitung), 500 und 503. Warten Sie retry-after Sekunden, wenn der Header vorhanden ist, und verwenden Sie andernfalls exponentielles Backoff mit Jitter. Senden Sie einen Idempotency-Key, damit eine wiederholte Sendung nie doppelt zugestellt wird, und warten Sie ein Tageslimit nicht in einer Anfrageschleife ab.

Terminal
# curl retries 429 and 5xx responses and honors retry-after.
curl https://api.emailit.com/v2/emails \
  --retry 5 --retry-max-time 60 \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-confirmation" \
  -d '{
    "from": "Acme <orders@acme.com>",
    "to": "ada@example.com",
    "subject": "Your order #1042",
    "text": "Thanks for your order."
  }'

Tipps für hohe Volumen

  • Senden Sie aus einer Warteschlange mit einer festen Anzahl von Workern, und bemessen Sie den Pool nach Ihrem Limit pro Sekunde.
  • Verteilen Sie große Batch-Jobs über den Tag, statt sie alle auf einmal zu starten, damit ein einzelner Job nicht das gesamte Tageskontingent verbraucht.
  • Beobachten Sie ratelimit-daily-remaining und verlangsamen Sie, bevor der Wert null erreicht.
  • Verwenden Sie für Newsletter an Ihre Kontaktlisten Kampagnen, statt den Sende-Endpunkt in einer Schleife aufzurufen.
Versandlimits und Tarifkontingente an einem Ort.
Der Wert, der automatische Limiterhöhungen steuert.
Sendungen wiederholen, ohne doppelt zu senden.
Alle Fehlerformate und Statuscodes.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.