Glossar
Codes, die uns beschreiben, nicht die Adresse
Einige Ursachencodes erklären, warum Emvero einen Prüfschritt ausgelassen oder nicht abgeschlossen hat. Sie beschreiben die Grenzen der Prüfung und belegen keinen Fehler des Postfachs.
Welche Codes die Arbeit von Emvero beschreiben
Das Feld reason_codes kann Angaben zur Adresse, Antworten des Mailservers und Grenzen des Prüfdienstes enthalten. Die Codes auf dieser Seite erklären, warum Emvero keine verwertbare Empfängerantwort erhalten hat. Sie sind ausgewählte Beispiele und kein vollständiger Katalog aller dienstseitigen Ursachen.
Ausgelassene und nicht ausführbare Schritte
SMTP_PROBE_NOT_REQUESTED bedeutet, dass die Anfrage keine SMTP-Postfachprüfung vorgesehen hat, etwa bei einer Domain-Prüfung. Der Schritt wurde absichtlich ausgelassen. Angaben zur Domain und andere vorhandene Belege können das Ergebnis trotzdem bestimmen.
Bei SMTP_PACING_REFUSED hält Emvero einen Versuch wegen seiner eigenen Begrenzung der Proben zurück. Mit SMTP_EGRESS_UNAVAILABLE meldet der Dienst, dass eine Ressource für die ausgehende Verbindung nicht verfügbar war. Bei SMTP_QUEUE_UNAVAILABLE oder SMTP_SCHEDULER_UNAVAILABLE konnte die Arbeit nicht in die Warteschlange aufgenommen oder eingeplant werden. Diese Codes melden keine Ablehnung durch den empfangenden Mailserver.
Was eine abgelaufene Frist über die Probe aussagt
SMTP_QUEUE_EXPIRED bedeutet, dass für den Versuch innerhalb der vorgesehenen Frist kein endgültiges Ergebnis vorlag. Die Frist kann während des Wartens, aber auch nach Beginn der Verarbeitung abgelaufen sein. Aus dem Code allein lässt sich nicht erkennen, ob eine Verbindung zum Zielserver geöffnet wurde.
SMTP_GREYLISTED hat dagegen einen anderen Ursprung: Der empfangende Mailserver hat vorübergehend abgelehnt. Auch eine SMTP-Ablehnung aus Richtliniengründen geht auf seine Antwort zurück. Mit dieser Unterscheidung erkennen Sie, ob Sie die Arbeit von Emvero oder die Reaktion des Mailservers betrachten müssen.
Wann Sie das Ergebnis erneut abrufen sollten
Bei SMTP_QUEUED mit pending läuft die Prüfung noch oder wartet auf ihre Ausführung. Rufen Sie dieselbe Prüfung nach der Wartezeit aus retry_after_ms erneut ab. Ein abgeschlossenes unknown bedeutet hingegen, dass die Belege keine eindeutige Entscheidung ermöglichen. Die Prüfung ist beendet; weiteres Warten auf ihre Ausführung hat dann keinen Zweck. Legen Sie in Ihrer Anwendung eine Wartefrist und eine Regel für offene Ergebnisse fest, etwa eine E-Mail-Bestätigung vor dem Zugang. Eine spätere neue Prüfung kann weitere Belege liefern, garantiert aber kein eindeutiges Ergebnis. Der Leitfaden zum Prüfergebnis erläutert Status, Aktion und einzelne Prüffelder.
Was der Dienst zurückgibt
Diese Codes gehören zum Vokabular der API und erklären eine Prüfung. Die Hinweise kennzeichnen auch Werte, die die aktuelle Prüfregel oder SMTP-Probe nicht zurückgibt.
SMTP_PROBE_ NOT_ REQUESTED - SMTP-Empfängerprüfung nicht angefragt
SMTP_PACING_ REFUSED - Probe wegen der internen Ratenbegrenzung von Emvero zurückgehalten
SMTP_EGRESS_ UNAVAILABLE - Ressource für die ausgehende Verbindung nicht verfügbar
SMTP_QUEUE_ UNAVAILABLE - Prüfung konnte nicht eingereiht werden
SMTP_QUEUE_ EXPIRED - Kein endgültiges Ergebnis der SMTP-Arbeit innerhalb der Frist; die Ausführung kann bereits begonnen haben
SMTP_SCHEDULER_ UNAVAILABLE - Prüfung konnte nicht eingeplant werden