POST an den Verifizierungsendpunkt
Senden Sie die Anfrage an https://api.listcleaner.net/verify_email. Verwenden Sie HTTPS und einen JSON-Anfragetext.
Node.js API-Leitfaden
E-Mail-Adressen mit Node.js bestätigen.
Senden Sie eine sichere JSON-Anfrage mit the built-in Fetch API, authentifizieren Sie sich mit Ihrer Konto-E-Mail-Adresse und Ihrem API-Schlüssel und verwenden Sie den zurückgegebenen Status direkt in Ihrer Anwendung.
Bevor Sie beginnen
Eine vollständige Node.js-Anfrage besteht aus vier Teilen.
Das Beispiel verwendet a current Node.js release with fetch support. Speichern Sie Anmeldeinformationen in serverseitigen Umgebungsvariablen und ersetzen Sie sie durch die Adresse, die Sie überprüfen müssen.
Senden Sie beide Anmeldeinformationsheader
Hinzufügen X-User-Email und X-Api-Key auf dem Server. Legen Sie niemals einen privaten API-Schlüssel im öffentlichen Browser JavaScript offen.
Geben Sie eine E-Mail-Adresse an
Codieren Sie die Adresse als JSON mit email Eigentum. Lassen Sie die JSON-Bibliothek der Sprache den Wert korrekt maskieren.
Lesen Sie den HTTP-Code und den JSON-Status
Zu einer erfolgreichen Antwort gehört: success, request_id, email und status. Behandeln Sie Fehler, bevor Sie diesen Feldern vertrauen.
Vollständige Anfrage
Kopieren Sie das Node.js-Beispiel.
Die kopierte Anfrage enthält die Header „Benutzername“ und „API-Schlüssel“. Ersetzen Sie die Beispielwerte durch serverseitige Konfiguration in der Produktion.
Nutzen Sie die Antwort
Behandeln Sie Transport-, API- und Verifizierungsergebnisse getrennt.
Ein HTTP-Erfolg bedeutet, dass die API die Anfrage verarbeitet hat. Die status beschreibt das Adressergebnis. Netzwerkausfälle, Zeitüberschreitungen, Authentifizierungsfehler und unzureichendes Guthaben erfordern eine andere Behandlung als eine unzustellbare Adresse.
- Überprüfen Sie den HTTP-Status. Analysieren Sie JSON nur, wenn ein Antworttext verfügbar ist.
- Überprüfen
success. Notieren Sie bei einem API-Fehler die Anforderungs-ID und verwenden Sie das dokumentierte Fehlerverhalten. - Verwenden Sie den Verifizierungsstatus. Ordnen Sie ListCleaner-Status einer expliziten Produktrichtlinie zu, anstatt davon auszugehen, dass jedes Nicht-OK-Ergebnis identisch ist.
- Behalten Sie die Anforderungs-ID bei. Es bietet eine sichere Referenz für Protokolle und Support, ohne dass Anmeldeinformationen offengelegt werden.
Beispiel einer Erfolgsantwort
{
"success": true,
"request_id": "7ad81f...",
"email": "customer@example.com",
"status": "OK"
}Die öffentliche Reaktion bleibt prägnant. Ihr Antrag entscheidet darüber, ob ein bestimmter Status angenommen, geprüft oder abgelehnt werden soll.
Checkliste für die Produktion
Machen Sie die Integration sicher und vorhersehbar.
Anmeldeinformationen schützen
Laden Sie die Benutzer-E-Mail-Adresse und den API-Schlüssel aus der Umgebung oder der geheimen Konfiguration. Übergeben Sie sie nicht an die Quellcodeverwaltung, protokollieren Sie sie nicht und geben Sie sie nicht an einen Browser zurück.
Legen Sie sinnvolle Timeouts fest
Verwenden Sie Verbindungs- und Gesamtanfrage-Timeouts. Behandeln Sie eine Transportzeitüberschreitung als nicht verfügbares Ergebnis und nicht als Beweis dafür, dass die übermittelte Adresse ungültig ist.
Loggen Sie sich sicher ein
Notieren Sie die Anforderungs-ID, den HTTP-Code, die Dauer und den Endstatus. Vermeiden Sie die unnötige Speicherung von Rohdaten oder vollständigen persönlichen Datensätzen.
Node.js-FAQ
Häufige Integrationsfragen.
Nutzen Sie die interaktive Dokumentation für die maßgeblichen Anforderungsfelder und die Live-Testkonsole.
Wo soll ich den API-Schlüssel ListCleaner speichern?
Speichern Sie es in einer serverseitigen Umgebung oder einer geheimen Konfiguration. Betten Sie es niemals in ein öffentliches JavaScript, ein mobiles Anwendungspaket oder eine festgeschriebene Quelldatei ein.
Wird bei der Einzelverifizierung eine E-Mail an die Adresse gesendet?
Nein. Der Endpunkt gibt seinen technischen Status zurück, ohne eine Bestätigungsnachricht an den Empfänger zu senden.
Soll ich jedes Ergebnis blockieren, das nicht in Ordnung ist?
Nein. Pauschale, vorübergehende und ungewisse Ergebnisse erfordern eine dokumentierte Richtlinie. Reservieren Sie eine harte Ablehnung für Status, die ausreichend starke Beweise für Ihren Anwendungsfall liefern.
Kann ich vollständige Dateien von Node.js bereinigen?
Ja. Die API unterstützt auch asynchrone Listenworkflows: Laden Sie eine unterstützte Datei hoch, behalten Sie die Job-ID bei, fragen Sie ihren Status ab und laden Sie das fertige Ergebnis herunter.
Andere Sprachen