Fehlercodes

Wie API-Fehler und SMTP-Antworten gemeldet werden und was bei jeder Art zu tun ist.

Format der API-Fehler

API-Fehler sind JSON mit stabilem Code und einer Meldung. Werten Sie in Ihrer Logik den Code aus und zeigen Sie die Meldung nur Menschen an, da sich der Wortlaut ändern kann.

{
  "error": { "code": "invalid_recipient", "message": "The recipient address is not valid." }
}

Wiederholen oder korrigieren?

Fehler fallen in zwei Gruppen. Anfrage korrigieren: 4xx-Antworten außer 429 bedeuten, dass an Ihrer Anfrage etwas nicht stimmt; ein erneuter Versuch scheitert genauso. Später erneut versuchen: 429- und 5xx-Antworten sind vorübergehend, wiederholen Sie also mit exponentiellem Backoff und begrenzter Versuchszahl.

SMTP-Antworten

SMTP-Antworten beginnen mit einem dreistelligen Code. 2xx bedeutet Erfolg. 4xx ist ein vorübergehender Fehler, der Absender sollte es später erneut versuchen. 5xx ist ein dauerhafter Fehler, senden Sie dieselbe Nachricht nicht erneut an diese Adresse. Viele Antworten ergänzen einen erweiterten Code wie 5.1.1, der die Ursache erklärt.

Bounce-Gründe lesen

Erweiterte Codes erklären einen Bounce am schnellsten. 5.1.1 heißt, das Postfach existiert nicht. 5.2.2 heißt, das Postfach ist voll. 5.7.1 heißt, der empfangende Server hat die Nachricht aus Richtliniengründen abgelehnt, oft wegen Authentifizierung oder Reputation. 4.x.x-Codes sind vorübergehend und werden erneut versucht.

Was bei Bounces zu tun ist

Entfernen Sie Adressen mit Hard Bounce aus Ihrer Liste und gehen Sie Ablehnungen aus Richtliniengründen nach, indem Sie Ihre SPF-, DKIM- und DMARC-Einrichtung prüfen. Eine steigende Bounce-Rate schadet Ihrer Reputation, handeln Sie also zügig.