Limits

Alles, was begrenzt ist, an einem Ort. Veröffentlicht statt entdeckt — eine Grenze, auf die man überraschend stößt, ist ein Fehler in der Dokumentation.

Auf einen Blick

1/sek
API-Anfragen pro Adresse
Einmal pro Sekunde abzufragen ist das vorgesehene Muster.
5Tage
Aufbewahrungsdauer von Nachrichten
Ab Eingang, gelesen oder nicht. Feste Frist.
5MB
Maximale Nachrichtengröße
Wird bereits bei SMTP abgelehnt, sodass der Absender informiert wird.
∞
Adressen pro Domain
Nichts wird im Voraus angelegt, also wird auch nichts gezählt.
200
Nachrichten pro Aufruf
Standard 50. Das begrenzt nur eine Antwort, nicht das Postfach: next blättert durch den Rest, egal wie viele es sind.
0
Ausgehende Nachrichten
Es gibt keinen Sende-Endpunkt. Mit Absicht.

Ratenlimit

Eine Anfrage pro Sekunde, pro Adresse. Das Limit gilt pro Postfach, nicht pro IP — ein gemeinsamer CI-Runner, der zwanzig verschiedene Postfächer abfragt, steht sich also nicht selbst im Weg.

Über dem Limit erhalten Sie 429 mit einem Retry-After-Header in ganzen Sekunden. Es gibt kein Tages- oder Monatskontingent und kein Burst-Guthaben zu verwalten.

Es gibt eine zweite Obergrenze, und sie wird hier genannt statt zum Entdecken überlassen: 1200 Anfragen pro Minute von einer Quelladresse. Das entspricht genau dem oben genannten Beispiel von zwanzig Postfächern pro Sekunde, sodass normale Automatisierung sie nie erreicht — sie verhindert, dass ein einzelner Host zehntausend Adressen pro Sekunde durchgeht.

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error":   "rate_limited",
  "message": "one request per second, per address"
}

Warten Sie gemäß Retry-After, statt eine feste Pause einzubauen. Ändert sich das Limit, funktioniert Code, der den Header ausliest, weiterhin.

Nachrichtengröße

Nachrichten bis 5 MB, Anhänge eingerechnet. Diese Grenze wird vom Mailserver während der SMTP-Verbindung durchgesetzt – das ist wichtig: Der sendende Server erfährt es im Moment des Versuchs und meldet seinem Nutzer einen echten Fehler, statt dass die Nachricht einfach verschwindet.

Was zählt: Die gesamte codierte Nachricht — Header, Text und jeder Anhang nach der MIME-Codierung. Base64 vergrößert eine Binärdatei um etwa ein Drittel, sodass eine 20-MB-Datei nah an der Grenze liegt.
Was auf der Leitung passiert: Ein 552 zum SMTP-Zeitpunkt. Die Nachricht wird nie gespeichert und erscheint nie im Postfach.
Anhänge pro Nachricht: Nicht getrennt gedeckelt. Entscheidend ist die Gesamtsumme.

Aufbewahrung

Eine Nachricht wird 5 Tage nach ihrem Eintreffen gelöscht, gelesen oder nicht, und die Frist beginnt mit der Zustellung, nicht mit dem ersten Lesen.

Jede Nachricht trägt expires_at, sodass ein Client dieses Datum nie selbst berechnen oder die Regel im Blick behalten muss.

Es ist eine feste Frist, keine Einstellung: Kein Parameter, Plan oder Konto verlängert sie. Muss etwas länger erhalten bleiben, holen und speichern Sie es auf Ihrer Seite.

Adressen und Domains

Adressen pro Domain: Unbegrenzt und nicht gezählt. Da ein Postfach nie erstellt wird, gibt es keine Liste davon, die wachsen könnte.
Regeln für den Lokalteil: Ein bis 64 Zeichen: Buchstaben, Ziffern, Punkt, Bindestrich, Unterstrich und Pluszeichen. Sie muss mit einem Buchstaben oder einer Ziffer beginnen und enden. Alles andere wird abgelehnt, bevor es den Mailserver erreicht – im Browser und erneut auf dem Server.
Plus-Adressierung: name+tag@domain ist hier ein eigenständiges Postfach, kein Alias von name@domain. Das ist Absicht — Tags dienen dazu, Anmeldungen zu trennen, und sie zusammenzuführen würde Postfächer vermischen, die getrennt bleiben sollten.
Groß-/Kleinschreibung: Alles wird klein geschrieben. Name@ und name@ sind dasselbe Postfach.
Eigene Domains: Keine Begrenzung, wie viele Domains Sie hierher zeigen lassen. Jede braucht ihren eigenen MX-Eintrag.

Angemessene Nutzung

Es gibt kein Kontingent, das Sie sich freikaufen können, und keinen Tarif, der diese Werte anhebt. Stattdessen gilt: Wenn eine einzelne Quelle den Dienst für alle anderen verschlechtert, wird sie gestoppt.

Massenabfragen: Tausende Postfächer, die jede Sekunde von einer Quelle abgefragt werden, werden am Rand gedrosselt, bevor sie die API erreichen.
Mail-Fluten: Ein sendender Host, der unverhältnismäßig viele SMTP-Verbindungen öffnet, wird für zehn Minuten gesperrt. Normale Absender kommen dem nie nahe.
Uns als Relay verwenden: Unmöglich statt verboten: Der Mailserver nimmt nur Nachrichten an, die an hier gehostete Domains adressiert sind, und kann daher nichts weiterleiten.

Nichts davon ist für gelegentliche Automatisierung gedacht. Einmal pro Sekunde abfragen, den ganzen Tag, über Tausende Postfächer hinweg – das ist der vorgesehene Gebrauch, nicht sein Grenzfall.