O tym filmie

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

Transkrypcja filmu

1. 00:00Pierwsze zapytanie

   Pierwsze zapytanie to POST na /verify/single. Wyślij jedno pole JSON, email. Umieść klucz API w nagłówku BV-API-KEY. To całe zapytanie. Trzymaj ten klucz w zmiennej środowiskowej na serwerze, nigdy w kodzie klienta. Utworzenie klucza wymaga płatnego konta, a odblokowuje je każdy zakup kredytów.

2. 00:24Odczytaj odpowiedź

   To prawdziwa odpowiedź dla adresu supportu. Zacznij od status. Mówi role, bo support to nazwa wspólnej skrzynki, a nie osoby. Wynik to 0,6. To wartość z ustalonych reguł, a nie prawdopodobieństwo. Rozgałęziaj więc po status, a nie po wyniku. Is deliverable ma wartość true, więc serwer poczty przyjął ten adres. Is catch-all też ma wartość true, więc ta domena przyjmuje każdy adres. Role zajmuje status, a flagi nadal pokazują resztę. Reason podaje powód jako jeden kod. Tutaj to catch-all deliverable.

3. 01:02Dlaczego credits_used to 0

   Dokumentacja ma stronę z listą wszystkich kodów. Teraz credits used. Tutaj to zero, ale to nie znaczy, że kontrole są darmowe. To konto już sprawdzało ten adres w ciągu ostatnich 24 godzin, więc powtórka nie została obciążona. Pierwsza kontrola, taka jak ta, kosztuje jeden kredyt. Verification mode mówi, skąd pochodzi odpowiedź. Ta pochodzi z historii w pamięci podręcznej. Użyj go, by zrozumieć wynik. Do rozliczeń czytaj credits used.

4. 01:23Do 50 adresów

   Masz krótką listę? Użyj /verify/bulk. Nagłówek zostaje ten sam, a treść zapytania przyjmuje tablicę emails, do 50 adresów. Wyniki wracają w tej samej odpowiedzi. Każdy adres dostaje te same pola, które właśnie widać. Pierwszy to catch-all. Drugi jest nieprawidłowy, bo ta skrzynka nie istnieje. Trzeci jest jednorazowy. Wszystkie trzy zużyły kredyt. Nieprawidłowy się liczy. Jednorazowy liczy się tutaj, bo to zapytanie ustawiło check_smtp na true. Pomiń to, a trafienie jednorazowe zatrzymuje się wcześnie, bez opłaty. Domyślnie więc nieznany, błędna składnia i jednorazowy nic nie kosztują. Wszystko inne to jeden kredyt, w tym catch-all i rola. Pod wynikami dostajesz sumy. Valid emails to zero, bo catch-all nie jest liczony jako prawidłowy. A kategorie grupują partię: jeden użyteczny z catch-all, dwa niedostarczalne. Wyślij więcej niż 50, a dostaniesz HTTP 400 z kodem 3103. Lista nie jest dzielona za Ciebie i nie staje się zadaniem plikowym. Błąd wskazuje endpoint plikowy.

5. 02:28Większe listy

   Dla większych list prześlij plik. Działa asynchronicznie, więc przesłanie daje identyfikator zadania. Użyj go, by sprawdzać postęp. Gdy zadanie się skończy, pobierz wyniki. Zachowaj flagę -L, bo pobieranie może przekierowywać. Pobranie to CSV. Twoje oryginalne kolumny zostają, a nowe następują po nich, jak ev_status i ev_reason.

6. 02:49Sprawdź swoje kredyty

   /credits mówi, ile zostało. To GET, z tym samym nagłówkiem. Sprawdź to przed dużym przesłaniem, bo bez wystarczającej liczby kredytów API zwraca 402.

7. 03:00Dwie opcje zapytania

   Dwie opcje zmieniają działanie kontroli. SMTP jest domyślnie włączone i żaden e-mail nigdy nie jest wysyłany. check_smtp false pomija serwer poczty, więc większość adresów wraca jako nieznane. force_refresh true pomija pamięć podręczną, a Ty płacisz za nowy wynik.

8. 03:17Błędy i limity

   Najpierw obsłuż trzy błędy. 401 to brakujący lub nieprawidłowy klucz. 402 oznacza za mało kredytów. 429 to limit zapytań, więc zwolnij i spróbuj ponownie. Limity obowiązują na klucz API. 6000 zapytań na minutę dla single. 1500 dla bulk.

9. 03:37Następne kroki

   300 dla przesyłania plików. To cały szybki start. Single, bulk, pliki i kredyty. Pełna dokumentacja API, SDK i webhooki są na billionverify.com/docs. 20 darmowych kredytów za każdy dzień korzystania z konta, do 600 miesięcznie. Karta kredytowa nie jest wymagana. Zacznij na billionverify.com.

Pokazane w tym filmie