Produktleitfaden
API zur Prüfung der E-Mail-Zustellbarkeit: Umgang mit zustellbaren und unzustellbaren Ergebnissen
Erfahren Sie, wie Sie die API zur Prüfung der E-Mail-Zustellbarkeit integrieren, um zustellbare, unzustellbare und unbestimmte Catch-All-Ergebnisse zu verarbeiten.
Integrieren Sie die API zur Prüfung der E-Mail-Zustellbarkeit, um zustellbare und unzustellbare Adressen von unbestimmten Catch-All-Domains in synchronen und Bulk-Workflows zu unterscheiden.
EmailCheckPro bietet eine API zur Prüfung der E-Mail-Zustellbarkeit, die zum Zeitpunkt der Prüfung feststellt, ob eine Adresse zustellbar (kann E-Mails empfangen) oder unzustellbar ist. Ein zustellbares Ergebnis zeigt an, dass die Adresse zum Zeitpunkt der Prüfung Nachrichten empfangen kann, während ein unzustellbares Ergebnis eine Adresse identifiziert, die keine E-Mails empfangen kann. Der Dienst bewertet Adressen über nahezu jede Domain hinweg, ohne Nachrichten an die Zieladressen zu versenden. Durch die Integration von Echtzeit- und Bulk-API-Workflows können Entwicklungsteams aktive Empfängeradressen von unzustellbaren Datensätzen und unbestimmten Catch-All-Domains trennen, wodurch die Übertragungsqualität verbessert und die Datenhygiene in den Erfassungssystemen gewahrt wird.
Zentrale Zustellbarkeitsergebnisse und operativer Geltungsbereich
Die Bewertung von Empfängeradressen erfordert eine klare Unterscheidung zwischen zustellbaren, unzustellbaren und unbestimmten Ergebnissen.
Ein zustellbares Ergebnis bestätigt, dass die Empfängeradresse zum Zeitpunkt der Überprüfung erreichbar und bereit war, E-Mails zu empfangen. Umgekehrt weist ein unzustellbares Ergebnis darauf hin, dass die Adresse keine Nachrichten empfangen kann. Beide Ergebnisse stellen abgeschlossene Prüfergebnisse dar.
Zustellbarkeitsbewertungen liefern punktuelle Erreichbarkeitssignale und keine dauerhaften Garantien. Entwicklungsteams nutzen diese Signale, um inaktive Adressen aus Kommunikationswarteschlangen zu entfernen. Dies trägt dazu bei, die Infrastrukturleistung zu schützen und gleichzeitig die europäischen Grundsätze zur Datenminimierung gemäß GDPR Article 5 (Regulation (EU) 2016/679) einzuhalten.
Synchrone Integration für Einzel- und Stapelprüfungen
Anwendungen, die Kontaktdaten bei der Registrierung oder bei Profilaktualisierungen erfassen, erfordern eine schnelle, synchrone Auswertung. EmailCheckPro stellt zwei dedizierte Echtzeit-Endpunkte für interaktive Workflows bereit.
Für einzelne Übermittlungen fragen Entwickler POST /api/v1/check mit einer einzelnen vollständigen Adresse ab.
Bei der Verarbeitung kleiner Mengen von Benutzereingaben verarbeitet POST /api/v1/batch-check 1 bis 100 Adressen synchron innerhalb einer einzigen HTTP-Anfrage. Die Antwort der Mehrfachprüfung behält die exakte Reihenfolge der Eingabeliste bei. Jeder Datensatz enthält neben den Prüfdetails eine exists Eigenschaft. In diesem Schema bedeutet exists=false, dass der Dienst für diesen Eintrag kein abgeschlossenes Ergebnis generiert hat, anstatt ein unzustellbares Ergebnis auszugeben. Diese Unterscheidung ermöglicht es Erfassungssystemen, bei vorübergehenden Problemen einen erneuten Versuch zu unternehmen und gleichzeitig bestätigte unzustellbare Einträge sicher herauszufiltern.
Asynchrone Bulk-Aufgaben für die Listenverarbeitung
Die Pflege großer Datenbankarchive erfordert eine asynchrone Verarbeitungsarchitektur. Bei der Überprüfung von Kontaktbeständen übermitteln Systeme die Prüfaufträge über POST /api/v1/bulk-tasks.
Bulk-Übermittlungen akzeptieren strukturierte TXT- oder CSV-Dateien, die pro Zeile eine vollständige E-Mail-Adresse enthalten. Während des Dateieinzugs entfernt die Plattform automatisch doppelte Zeilen und fehlerhafte Einträge, um einen bereinigten Auftrag vorzubereiten. Es gelten die dokumentierten Mengengrenzen pro Produkt; Teams sollten die offizielle Dokumentation für aktuelle Auftragslimits prüfen.
Da Bulk-Aufträge asynchron ausgeführt werden, überwachen Anwendungen den Fortschritt über GET /api/v1/bulk-tasks/{id}. Client-Workflows sollten diesen Endpunkt nicht häufiger als alle 30 Sekunden abfragen. Sobald die Verarbeitung abgeschlossen ist, stellt der Endpunkt eine result_url bereit, die auf eine CSV-Datei mit jedem Identifikator und dem zugehörigen Ergebnis verweist. Der generierte Download-Link bleibt 12 Stunden lang gültig und wird bei jeder erneuten Abfrage des Auftragsstatus aktualisiert.
Umgang mit unbestimmten Catch-Alls und Formatierungsausnahmen
Zuverlässige Datenqualitätspipelines müssen zwischen expliziten Zustellbarkeitsfehlern und mehrdeutigen oder falsch formatierten Eingaben unterscheiden.
Gemäß RFC 5322: Internet Message Format besteht eine E-Mail-Adresse aus einem lokalen Teil und einer Domain, die durch ein @-Symbol verbunden sind. Wenn einem eingehenden Eintrag diese Struktur fehlt, behandelt die API die Nutzlast als ungültiges Format. Ein ungültiges Format unterscheidet sich von einem unzustellbaren Ergebnis und stellt einen strukturellen Syntaxfehler dar.
Catch-All-Mailserver stellen eine weitere operative Kategorie dar. Diese Domains akzeptieren Nachrichten, die an einen beliebigen lokalen Benutzernamen adressiert sind, was die Prüf-Engine daran hindert, gültige Postfächer eindeutig zu isolieren. Anstatt Vermutungen anzustellen, markiert EmailCheckPro Catch-All-Konfigurationen als unbestimmt. Bei der Echtzeitprüfung geben Catch-All-Domains den Statuscode 42200 ohne abgeschlossenes Ergebnis zurück. Unbestimmte, ungültige und fehlgeschlagene Prüfungen verursachen keine Kosten, sodass Teams Catch-All-Datensätze an separate Prüfwarteschlangen weiterleiten können.
FAQ
Was unterscheidet ein unzustellbares Ergebnis von einem unbestimmten Ergebnis?
Echtzeitprüfungen für Catch-All-Domains geben den Statuscode 42200 ohne ein abgeschlossenes Ergebnis zurück, wodurch diese Adressen nicht berechnet werden und für separate Prüfrichtlinien zur Verfügung stehen.
Wie unterscheiden sich API-Anfragen für Mehrfachprüfungen von asynchronen Bulk-Aufgaben?
Aufrufe für Mehrfachprüfungen verwenden POST /api/v1/batch-check, um 1 bis 100 Adressen synchron zu validieren, wobei die Ergebnisse direkt innerhalb der HTTP-Antwort zurückgegeben werden und die Eingabereihenfolge erhalten bleibt. Asynchrone Bulk-Aufgaben verwenden POST /api/v1/bulk-tasks, um große TXT- oder CSV-Listen zu verarbeiten. Bulk-Aufgaben laufen offline, erfordern eine Abfrage von GET /api/v1/bulk-tasks/{id} in 30-Sekunden-Intervallen und geben eine herunterladbare CSV-Datei über eine result_url aus, die 12 Stunden lang gültig ist.
Erfahren Sie mehr
Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Workflow passen.