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 kodierte Nachricht — Header, Text und jeder Anhang nach der MIME-Kodierung. Base64 bläht eine Binärdatei um etwa ein Drittel auf, sodass eine Datei von rund 3,5 MB die Grenze bereits ausfüllt.
Was auf der Leitung passiert
Ein 552 zum SMTP-Zeitpunkt. Die Nachricht wird nie gespeichert und erscheint nie im Postfach.
Anhänge pro Nachricht
Zwanzig. In der Praxis wird zuerst die Größengrenze erreicht — aber eine Nachricht mit mehr als zwanzig Teilen mit Dateinamen behält die ersten zwanzig.

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.

Kontingente des Premium-Pools

Alles Obige beschreibt den kostenlosen Dienst, und der bleibt es: Die öffentlichen Domains und Ihre eigenen haben in keinem Tarif ein Nachrichtenkontingent oder eine Adressgrenze.

Ein bezahlter Tarif ergänzt 92 private .com-Domains, die von den Blocklisten für Wegwerf-Mail ferngehalten werden. Nur Nachrichten, die auf DIESEN Domains eintreffen, zählen gegen ein Kontingent: Premium USD 24/month (2.000 premium messages/month, 1 API key, 2 req/s); Pro USD 78/month (15.000 premium messages/month, 5 API keys, 3 req/s); Scale USD 148/month (36.000 premium messages/month, 20 API keys, 5 req/s).

Sie werden über dieselben Endpunkte gelesen, mit einem Authorization: Bearer-Schlüssel. Ohne ihn antwortet eine Premium-Adresse 402 oder 403 — nie mit einem Postfach.

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.

Willkommen zurück

Ihre Postfächer und Ihre Domains an einem Ort.