Über dieses Video

Die Antworten in diesem Video sind echte API-Antworten, gekürzt. API-Schlüssel und Dateiverifizierung erfordern ein kostenpflichtiges Konto.

Video-Transkript

1. 00:00Die Datei hochladen

   Laden Sie eine CSV an /verify/file hoch und lassen Sie sich dann per Webhook sagen, wann sie fertig ist. Bulk endet bei 50 Adressen. Für alles Größere senden Sie die ganze Datei als Multipart-Formulardaten. CSV, TXT und XLSX werden akzeptiert. email_column nennt die Spalte, die gelesen werden soll. Lassen Sie sie weg, wird sie für Sie erkannt. Das ist die Testdatei. Vier Zeilen und eine Spalte source, die wir in den Ergebnissen behalten wollen. Der Upload wartet nicht auf die Prüfungen. Er antwortet mit einer Task-ID und dem Status pending. Er sagt Ihnen auch, welche Spalte er gelesen hat und wie viele Zeilen und eindeutige Adressen er gefunden hat. Wie der API-Schlüssel selbst sind Dateijobs für kostenpflichtige Konten.

2. 00:43Den Job verfolgen

   Um nachzusehen, senden Sie ein GET an denselben Pfad mit angehängter Task-ID. Derselbe Header, kein Body. Sofort abgefragt, war diese kleine Datei schon beim Zusammenführen. Während der Job läuft, geht der Status durch Schritte wie preparing, pending, processing und merging. Hören Sie auf zu fragen, sobald Sie completed, completed with warning, failed oder cancelled sehen. Hier der fertige Job. Die Zähler teilen die Datei nach Status auf: eine ungültige, eine Rolle, eine Catch-all und eine Wegwerf. credits_used ist eins, und cache_hit_not_charged ist drei. Drei Zeilen waren Neuprüfungen. Diese Adressen wurden in den letzten 24 Stunden mit diesem Konto geprüft, und eine Neuprüfung innerhalb von 24 Stunden wird nicht berechnet. Dazu kommen zwei Links. download_url ist der stabile API-Pfad, speichern Sie also diesen. direct_download_url ist ein signierter Speicherlink und funktioniert nach dem angezeigten Ablaufzeitpunkt nicht mehr.

3. 01:35Die Ergebnisse abrufen

   Rufen Sie results auf und speichern Sie die Ausgabe in einer Datei. Ohne Filter leitet die API auf die vollständige Ergebnisdatei um, und dash L folgt dieser Weiterleitung. Ihre Spalten stehen zuerst, unverändert. Danach folgen die ev_-Spalten, etwa status, score und reason, in jeder Zeile. Brauchen Sie nur die Zeilen, die entfernt werden sollen? Fügen Sie Filter hinzu. Sie werden mit ODER verknüpft, dies fragt also nach ungültig oder Wegwerf. Mit einem Filter wird die CSV erstellt und direkt zurückgesendet. Zwei Zeilen kommen zurück, die zu entfernenden.

4. 02:04Einen Webhook nutzen

   Polling funktioniert, aber bei einem langen Job heißt das viele Anfragen. Ein Webhook dreht es um. BillionVerify ruft Ihren Server auf, wenn ein Dateijob endet oder fehlschlägt. Registrieren Sie einen mit einem POST an /webhooks. Geben Sie eine HTTPS-Adresse und die gewünschten Ereignisse an. Es gibt zwei: file.completed und file.failed. Diese Antwort enthält ein Signing Secret, und Sie sehen es nur dieses eine Mal. Speichern Sie es sofort. Sie brauchen es, um jede Zustellung zu prüfen. Jede Zustellung ist ein JSON-POST mit drei Headern: dem Ereignis, einem Zeitstempel und einer Signatur. Der Body nennt das Ereignis und die Zeit. Seine data enthält die Job-ID, die Zähler, die verbrauchten Credits und die Download-Links.

5. 02:44Die Signatur prüfen

   Prüfen Sie die Signatur, bevor Sie auf eine Zustellung reagieren. Verbinden Sie den Zeitstempel-Header, einen Punkt und den rohen Body. Berechnen Sie darüber HMAC-SHA256 mit Ihrem Secret und vergleichen Sie mit dem Signatur-Header. Hashen Sie den Body exakt so, wie er ankam. Geparstes und neu kodiertes JSON stimmt nicht überein. Und lehnen Sie veraltete Zeitstempel ab, damit eine alte Anfrage nicht erneut abgespielt werden kann. Der ganze Ablauf ist also kurz. Hochladen, die Task-ID speichern, auf den Webhook warten und dann die Ergebnisse über den stabilen Link abrufen.

6. 03:11Nächste Schritte

   Statuswerte, Filter und jedes Webhook-Feld stehen in der API-Referenz unter billionverify.com/docs/api-reference. 20 kostenlose Credits an jedem Tag, an dem Sie Ihr Konto nutzen, bis zu 600 pro Monat. Keine Kreditkarte nötig. Starten Sie auf billionverify.com.