O tym filmie

Odpowiedzi w tym filmie to prawdziwe odpowiedzi API, skrócone. Klucze API i weryfikacja plików wymagają płatnego konta.

Transkrypcja filmu

1. 00:00Prześlij plik

   Prześlij CSV na /verify/file, a potem pozwól, by webhook powiedział Ci, kiedy będzie gotowe. Bulk kończy się na 50 adresach. Dla czegokolwiek większego wyślij cały plik jako multipart form data. Akceptowane są CSV, TXT i XLSX. email_column wskazuje kolumnę do odczytu. Pomiń go, a zostanie wykryta za Ciebie. To plik testowy. Cztery wiersze plus kolumna source, którą chcemy zachować w wynikach. Przesłanie nie czeka na kontrole. Odpowiada identyfikatorem zadania i statusem pending. Mówi też, którą kolumnę odczytało oraz ile wierszy i unikalnych adresów znalazło. Tak jak sam klucz API, zadania plikowe są dla kont płatnych.

2. 00:43Śledź zadanie

   Aby je sprawdzić, wyślij GET na tę samą ścieżkę z dopisanym identyfikatorem zadania. Ten sam nagłówek, bez treści. Zapytany od razu, ten mały plik już się scalał. W trakcie pracy status przechodzi przez kroki takie jak preparing, pending, processing i merging. Przestań pytać, gdy zobaczysz completed, completed with warning, failed lub cancelled. Oto zakończone zadanie. Liczniki dzielą plik według statusu: jeden nieprawidłowy, jeden rola, jeden catch-all i jeden jednorazowy. credits_used to jeden, a cache_hit_not_charged to trzy. Trzy wiersze były ponownymi kontrolami. Te adresy były sprawdzane na tym koncie w ciągu ostatnich 24 godzin, a ponowna kontrola w ciągu 24 godzin nie jest obciążana. Dołączone są dwa linki. download_url to stała ścieżka API, więc to ją warto zapisać. direct_download_url to podpisany link do magazynu i przestaje działać w pokazanym czasie wygaśnięcia.

3. 01:35Pobierz wyniki

   Wywołaj results i zapisz wynik do pliku. Bez filtrów API przekierowuje do pełnego pliku wyników, a dash L podąża za tym przekierowaniem. Twoje kolumny są pierwsze, bez zmian. Potem w każdym wierszu następują kolumny ev_, takie jak status, score i reason. Potrzebujesz tylko wierszy do usunięcia? Dodaj filtry. Łączą się przez OR, więc to zapytanie prosi o nieprawidłowe lub jednorazowe. Z filtrem plik CSV jest budowany i odsyłany od razu. Wracają dwa wiersze, te do usunięcia.

4. 02:04Użyj webhooka

   Odpytywanie działa, ale przy długim zadaniu oznacza dużo zapytań. Webhook odwraca to. BillionVerify wywołuje Twój serwer, gdy zadanie plikowe się kończy lub zawodzi. Zarejestruj go przez POST na /webhooks. Podaj adres HTTPS i zdarzenia, które chcesz. Są dwa: file.completed i file.failed. Ta odpowiedź zawiera sekret podpisu i jest to jedyny raz, kiedy go zobaczysz. Zapisz go od razu. Potrzebujesz go do sprawdzania każdego dostarczenia. Każde dostarczenie to POST z JSON-em i trzema nagłówkami: zdarzeniem, znacznikiem czasu i podpisem. Treść wymienia zdarzenie i czas. Jej pole data zawiera ID zadania, liczniki, zużyte kredyty i linki do pobrania.

5. 02:44Sprawdź podpis

   Sprawdź podpis, zanim zareagujesz na dostarczenie. Połącz nagłówek ze znacznikiem czasu, kropkę i surową treść. Policz HMAC-SHA256 z tego, używając swojego sekretu, i porównaj z nagłówkiem podpisu. Policz skrót treści dokładnie w takiej postaci, w jakiej dotarła. Sparsowany i ponownie zakodowany JSON się nie zgodzi. I odrzucaj przestarzałe znaczniki czasu, żeby stare żądanie nie mogło zostać odtworzone. Cały przepływ jest więc krótki. Prześlij, zapisz ID zadania, poczekaj na webhook, a potem pobierz wyniki ze stałego linku.

6. 03:11Następne kroki

   Wartości statusów, filtry i każde pole webhooka są w dokumentacji API, pod adresem billionverify.com/docs/api-reference. 20 darmowych kredytów za każdy dzień korzystania z konta, do 600 miesięcznie. Karta kredytowa nie jest wymagana. Zacznij na billionverify.com.