Referenz
SMTP-Antwortcodes
Was jeder SMTP-Antwortcode bedeutet, ob er vorübergehend oder dauerhaft ist, wie Emailit damit umgeht und welche Antworten das SMTP-Relay von Emailit an Ihre App sendet.
Jeder SMTP-Befehl erhält eine dreistellige Antwort. Diese Seite listet die Codes auf, die Ihnen an zwei Stellen begegnen: in Antworten der Mailserver von Empfängern, wenn Emailit Ihre E-Mails zustellt, und in Antworten des SMTP-Relays von Emailit selbst, wenn Ihre App über smtp.emailit.com sendet.
Antworten lesen
Eine Antwort beginnt mit einem dreistelligen Code, meist gefolgt von einem erweiterten Statuscode und einer lesbaren Meldung:
550 5.1.1 <ada@example.com>: Recipient address rejected: User unknownDie erste Ziffer gibt das Ergebnis an:
| Erste Ziffer | Bedeutung | Was der Absender tun sollte |
|---|---|---|
2 |
Erfolg. Der Befehl wurde angenommen. | Fortfahren. |
3 |
Zwischenstand. Der Server braucht weitere Eingaben, etwa den Nachrichteninhalt nach DATA. |
Den nächsten Teil senden. |
4 |
Vorübergehender Fehler. Derselbe Befehl kann später funktionieren. | Später erneut versuchen. |
5 |
Dauerhafter Fehler. Den Befehl zu wiederholen, hilft nicht. | Nicht erneut versuchen, ohne etwas zu ändern. |
Die zweite Ziffer gibt die Kategorie an (0 Syntax, 1 Information, 2 Verbindung, 5 Mailsystem), die dritte Ziffer grenzt sie weiter ein. Server verwenden Codes oft ungenau. Lesen Sie daher immer auch den erweiterten Code und den Text der Meldung.
So verarbeitet Emailit Antworten von Empfangsservern
Wenn der Server eines Empfängers mit einem Fehler antwortet, erfasst Emailit einen Zustellversuch mit der vollständigen Antwort und entscheidet, ob es erneut versucht wird:
- Sofort gebounct. Antworten mit dem Code
550,551,553oder554sowie Antworten, deren Text den Fehler als dauerhaft bezeichnet. Die E-Mail erhält den Statusbounced. - Erneut versucht. Alles andere, darunter
421,450,451,452, Zeitüberschreitungen und Verbindungsfehler. Die E-Mail erhält den Statusattempted, und Emailit versucht es bis zu 7-mal über etwa 21 Stunden erneut (nach 10, 20, 40, 80, 160, 320 und 640 Minuten). Schlagen alle Versuche fehl, wird die E-Mail als Bounce gewertet und die Adresse gesperrt. - Trotz 4xx-Code als dauerhaft behandelt. Gängige Antworten wie „mailbox full“, „over quota“, „user unknown“, „mailbox disabled“ und „relay access denied“ werden zu einem dauerhaften Fehler umgewertet, weil erneute Versuche hier selten funktionieren.
- Backoff. Eine
451-Antwort pausiert die Zustellung von dieser sendenden IP an diese Empfängerdomain für 5 Minuten. Eine Blockierung mit550 5.7.1(aus anderen Gründen als dem Inhalt) pausiert sie für 1 Stunde. E-Mails, die auf eine Pause treffen, werden alsattemptedmarkiert und nach dem normalen Zeitplan erneut versucht.
Hard Bounces führen je nach Einstellungen Ihres Workspaces zur automatischen Sperrung. Ursachen und Lösungen nach Problem gruppiert finden Sie unter Bounce-Kategorien.
Referenz der Antwortcodes
Die Spalte „Emailit“ beschreibt, was passiert, wenn der Server eines Empfängers diesen Code während der Zustellung sendet.
2xx und 3xx: Erfolg und Zwischenstand
| Code | Bedeutung | Typ | Emailit |
|---|---|---|---|
220 |
Dienst bereit. Die Begrüßung des Servers, die auch vor einem STARTTLS-Handshake gesendet wird. |
Erfolg | Setzt die Kommunikation fort. |
221 |
Verbindung wird geschlossen, meist nach QUIT. |
Erfolg | Keine Aktion. |
235 |
Authentifizierung erfolgreich. | Erfolg | Wird bei der Zustellung an Empfänger nicht verwendet; das Relay von Emailit sendet ihn nach AUTH an Ihre App. |
250 |
Angeforderte Aktion abgeschlossen. Nach DATA hat der Server die Nachricht angenommen. |
Erfolg | Markiert die E-Mail als delivered. |
251 |
Nutzer nicht lokal; der Server leitet die Nachricht weiter. | Erfolg | Wird wie 250 behandelt. |
252 |
Der Server kann den Nutzer nicht verifizieren, versucht aber die Zustellung. | Erfolg | Wird wie 250 behandelt. |
354 |
Beginnen Sie mit dem Senden des Nachrichteninhalts und beenden Sie ihn mit einer Zeile, die nur einen Punkt enthält. | Zwischenstand | Sendet die Nachricht. |
4xx: vorübergehende Fehler
| Code | Bedeutung | Typ | Emailit |
|---|---|---|---|
421 |
Dienst nicht verfügbar, Verbindung wird geschlossen. Oft zu viele Verbindungen oder eine vorübergehende Blockierung wegen der Reputation. | Vorübergehend | Erneut versucht. Varianten für volles Postfach und nicht verfügbares Konto werden gebounct. |
450 |
Postfach nicht verfügbar, etwa ausgelastet, gesperrt oder durch Greylisting. | Vorübergehend | Erneut versucht. Varianten für Kontingent, unbekannten Nutzer und deaktiviertes Postfach werden gebounct. |
451 |
Lokaler Verarbeitungsfehler, oft Rate Limiting oder Greylisting. | Vorübergehend | Erneut versucht, mit 5 Minuten Backoff für diese IP und Domain. Varianten für überschrittenes Kontingent und inaktives Postfach werden gebounct. |
452 |
Unzureichender Systemspeicher oder zu viele Empfänger in einer Übertragung. | Vorübergehend | Erneut versucht. Varianten für Kontingent, Speicher und volles Postfach werden gebounct. |
454 |
Vorübergehender Authentifizierungs- oder TLS-Fehler. | Vorübergehend | Erneut versucht. Varianten mit „Relay access denied“ werden gebounct. |
5xx: dauerhafte Fehler
| Code | Bedeutung | Typ | Emailit |
|---|---|---|---|
500 |
Syntaxfehler, Befehl nicht erkannt. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
501 |
Syntaxfehler in Parametern oder Argumenten, etwa eine fehlerhafte Adresse. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
502 |
Befehl nicht implementiert. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
503 |
Falsche Reihenfolge der Befehle. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
504 |
Befehlsparameter nicht implementiert. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
521 |
Die Domain nimmt keine E-Mails an (RFC 7504). | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
530 |
Authentifizierung erforderlich, oder der Server verlangt zuerst TLS. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
534 |
Authentifizierungsmethode zu schwach. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
535 |
Zugangsdaten ungültig. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
538 |
Verschlüsselung für die angeforderte Authentifizierungsmethode erforderlich. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
550 |
Postfach nicht verfügbar: Die Adresse existiert nicht, oder der Server hat die Nachricht aus Richtlinien- oder Spamgründen abgelehnt. | Dauerhaft | Gebounct. Blockierungen mit 550 5.7.1 lösen außerdem 1 Stunde Backoff für diese IP und Domain aus. |
551 |
Nutzer nicht lokal; der Server leitet nicht weiter. | Dauerhaft | Gebounct. |
552 |
Postfach voll oder Nachricht überschreitet die Größenbeschränkung des Servers. | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. Bekannte Antworten zu überschrittenem Kontingent werden sofort gebounct. |
553 |
Postfachname nicht zulässig, etwa eine ungültige Adresse. | Dauerhaft | Gebounct. |
554 |
Übertragung fehlgeschlagen, oft eine Ablehnung wegen Richtlinie, Spam oder Reputation. Wird auch als Begrüßung gesendet, wenn ein Server die Verbindung verweigert. | Dauerhaft | Gebounct. |
555 |
Parameter von MAIL FROM oder RCPT TO nicht erkannt. |
Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
556 |
Die Domain nimmt keine E-Mails an (RFC 7504). | Dauerhaft | Erneut versucht, nach dem letzten Versuch gebounct. |
Antworten des SMTP-Relays von Emailit
Wenn Ihre App über smtp.emailit.com sendet, kann Emailit diese Antworten zurückgeben. Antworten auf die Befehle MAIL und DATA auf einer authentifizierten Verbindung erscheinen außerdem mit ihrem Statuscode unter Email APILogs.
| Antwort | Befehl | Ursache | Was zu tun ist |
|---|---|---|---|
235 Authentication successful |
AUTH |
Der API-Schlüssel wurde akzeptiert. | Fortfahren. |
535 Authentication failed |
AUTH |
Das Passwort ist für keinen Workspace ein gültiger API-Schlüssel. | Verwenden Sie einen aktuellen API-Schlüssel als Passwort. Der Benutzername kann emailit lauten. |
454 Temporary authentication failure |
AUTH |
Emailit konnte den Schlüssel wegen eines internen Fehlers nicht prüfen. | Versuchen Sie es nach kurzer Zeit erneut. |
504 Error: Unrecognized authentication type |
AUTH |
Ihr Client hat eine andere Methode als PLAIN oder LOGIN verwendet, etwa CRAM-MD5. |
Stellen Sie den Client auf PLAIN oder LOGIN um. |
452 4.4.5 Messages per second limit exceeded (n/limit) |
MAIL FROM |
Der Workspace hat sein Versandlimit pro Sekunde erreicht. API und SMTP teilen sich das Limit. | Senden Sie langsamer und versuchen Sie es erneut. Die meisten Mail-Bibliotheken wiederholen 4xx-Antworten automatisch. |
452 4.5.3 Daily message limit exceeded (n/limit) |
MAIL FROM |
Der Workspace hat sein Tageslimit erreicht, das um 00:00 UTC zurückgesetzt wird. | Warten Sie auf das Zurücksetzen oder beantragen Sie in der Weboberfläche ein höheres Limit. |
451 Temporary local error in processing |
MAIL FROM, RCPT TO, DATA |
Ein vorübergehendes Problem bei Emailit. | Versuchen Sie es später erneut. |
530 Authentication required |
RCPT TO |
Der Client hat sich vor dem Senden nicht angemeldet. | Aktivieren Sie die SMTP-Authentifizierung in Ihrem Client. |
501 Invalid RCPT TO format |
RCPT TO |
Die Empfängeradresse ist fehlerhaft. | Korrigieren Sie die Adresse. |
550 Unverified workspaces can only send to workspace members' account emails. |
RCPT TO |
Der Workspace ist im Sandbox-Modus und der Empfänger ist kein Mitglied. | Senden Sie an die E-Mail-Adresse des Kontos eines Mitglieds oder beantragen Sie Produktionszugang. |
535 Mail server has been suspended |
RCPT TO |
Der Workspace ist gesperrt. | Prüfen Sie Ihre Versandgesundheit und kontaktieren Sie den Support. |
530 From/Sender domain is not verified for this workspace. From: ... |
DATA |
Der Header From liegt nicht auf einer verifizierten Versanddomain des Workspaces. Subdomains müssen separat verifiziert werden. |
Verifizieren Sie die Domain oder ändern Sie die Absenderadresse. |
530 API key is restricted to sending domain: acme.com. ... |
DATA |
Der API-Schlüssel ist auf eine Domain beschränkt, und die Adresse in From verwendet eine andere. |
Verwenden Sie die erlaubte Domain oder einen anderen Schlüssel. |
550 Sending from this domain is paused |
DATA |
Die Domain wurde pausiert, meist wegen einer hohen Bounce-Rate. | Siehe Versandgesundheit. |
552 Message too large (maximum size 40MB) |
DATA |
Die Nachricht ist einschließlich kodierter Anhänge größer als 40 MB. | Senden Sie kleinere Anhänge oder verlinken Sie stattdessen auf Dateien. |
550 Loop detected |
DATA |
Die Nachricht hat das Relay von Emailit bereits mehr als 4-mal durchlaufen. | Prüfen Sie Weiterleitungsregeln, die E-Mails an Emailit zurücksenden. |
550 Message processing failed |
DATA |
Emailit konnte die Nachricht nicht speichern. | Versuchen Sie es erneut. Schlägt es weiterhin fehl, kontaktieren Sie den Support und nennen Sie den Zeitpunkt des Versuchs. |
250 2.0.0 OK: queued as em_... |
DATA |
Emailit hat die Nachricht angenommen. Jeder Empfänger erhält eine eigene E-Mail-ID, durch Kommas getrennt aufgeführt, sofern sie in die Antwort passen. | Speichern Sie die ID, um die E-Mail in der Weboberfläche oder per API nachzuschlagen. |
Das Relay sendet außerdem Standardantworten des Protokolls, etwa 220 beim Verbindungsaufbau, 503 Error: need MAIL command, wenn Befehle in falscher Reihenfolge eintreffen, und 421 Timeout - closing connection, wenn eine Verbindung untätig bleibt.