Über dieses Video

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

Video-Transkript

1. 00:00Ihre erste Anfrage

   Ihre erste Anfrage ist ein POST an /verify/single. Senden Sie ein JSON-Feld, email. Legen Sie Ihren API-Schlüssel in den Header BV-API-KEY. Das ist die ganze Anfrage. Bewahren Sie diesen Schlüssel in einer Umgebungsvariablen auf Ihrem Server auf, niemals in Client-Code. Zum Erstellen eines Schlüssels brauchen Sie ein kostenpflichtiges Konto, und jeder Credit-Kauf schaltet es frei.

2. 00:24Die Antwort lesen

   Das ist die echte Antwort für eine Support-Adresse. Beginnen Sie mit status. Er sagt role, weil support der Name eines gemeinsamen Postfachs ist, nicht einer Person. Der score beträgt 0,6. Das ist ein Wert aus festen Regeln, keine Wahrscheinlichkeit. Verzweigen Sie also nach status, nicht nach dem score. is_deliverable ist true, der Mailserver hat diese Adresse also angenommen. is_catch_all ist ebenfalls true, diese Domain nimmt also jede Adresse an. Role bestimmt den Status, und die Flags zeigen den Rest. reason nennt das Warum als einen Code. Hier ist es catch-all deliverable.

3. 01:02Warum credits_used 0 ist

   Die Dokumentation hat eine Seite, die jeden Code auflistet. Nun credits_used. Hier ist es null, aber das heißt nicht, dass Prüfungen kostenlos sind. Dieses Konto hat diese Adresse in den letzten 24 Stunden schon geprüft, die Wiederholung wurde also nicht berechnet. Eine erste Prüfung wie diese kostet einen Credit. verification_mode sagt, woher die Antwort kam. Diese kam aus dem zwischengespeicherten Verlauf. Nutzen Sie es, um das Ergebnis zu verstehen. Für die Abrechnung lesen Sie credits_used.

4. 01:23Bis zu 50 Adressen

   Haben Sie eine kurze Liste? Nutzen Sie /verify/bulk. Der Header bleibt gleich, und der Body nimmt ein emails-Array, bis zu 50 Adressen. Die Ergebnisse kommen in derselben Antwort zurück. Jede Adresse bekommt dieselben Felder, die Sie gerade gesehen haben. Die erste ist Catch-all. Die zweite ist ungültig, weil dieses Postfach nicht existiert. Die dritte ist Wegwerf. Alle drei haben einen Credit verbraucht. Ungültig zählt. Die Wegwerf-Adresse zählt hier, weil diese Anfrage check_smtp auf true gesetzt hat. Lassen Sie das weg, und ein Wegwerf-Treffer bricht früh ab, ohne Kosten. Standardmäßig kosten also unbekannt, fehlerhafte Syntax und Wegwerf nichts. Alles andere kostet einen Credit, Catch-all und Rolle eingeschlossen. Unter den Ergebnissen stehen Summen. Gültige E-Mails ist null, weil Catch-all nicht als gültig zählt. Und die Buckets gruppieren die Charge: eine nutzbar mit Catch-all, zwei nicht zustellbar. Senden Sie mehr als 50, bekommen Sie HTTP 400 mit dem Code 3103. Die Liste wird nicht für Sie aufgeteilt und auch nicht zu einem Datei-Job. Der Fehler verweist Sie auf den Datei-Endpoint.

5. 02:28Größere Listen

   Für größere Listen laden Sie eine Datei hoch. Das ist asynchron, der Upload liefert also eine Job-ID. Mit dieser ID prüfen Sie den Fortschritt. Ist der Job fertig, laden Sie die Ergebnisse herunter. Behalten Sie das Flag -L bei, denn der Download kann weiterleiten. Der Download ist eine CSV. Ihre ursprünglichen Spalten bleiben, und neue folgen, etwa ev_status und ev_reason.

6. 02:49Credits prüfen

   /credits sagt Ihnen, was übrig ist. Es ist ein GET mit demselben Header. Prüfen Sie es vor einem großen Upload, denn ohne genug Credits liefert die API einen 402.

7. 03:00Zwei Anfrageoptionen

   Zwei Optionen verändern, was eine Prüfung tut. SMTP ist standardmäßig an, und es wird nie eine E-Mail gesendet. check_smtp false überspringt den Mailserver, die meisten Adressen kommen dann als unbekannt zurück. force_refresh true überspringt den Cache, und Sie zahlen für das neue Ergebnis.

8. 03:17Fehler und Limits

   Behandeln Sie zuerst drei Fehler. 401 ist ein fehlender oder ungültiger Schlüssel. 402 heißt zu wenige Credits. 429 ist ein Rate Limit, warten Sie also kurz und versuchen Sie es erneut. Rate Limits gelten pro API-Schlüssel. 6.000 Anfragen pro Minute bei single. 1.500 bei bulk.

9. 03:37Nächste Schritte

   300 bei Datei-Uploads. Das war der Quickstart. Single, Bulk, Datei und Credits. Die vollständige API-Referenz, SDKs und Webhooks finden Sie unter billionverify.com/docs. 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.

In diesem Video gezeigt