🎬 Przedstawiamy transcript.im: darmowe transkrypcje filmów z YouTube, TikToka i Instagrama.Wypróbuj transcript.im

API weryfikacji e-mail

API weryfikacji e-maili w czasie rzeczywistym przez HTTP z pełnymi testami skrzynek SMTP — dokładne API do oceny dostarczalności, a nie tylko poprawności formatu.

Konsola Email Verification API z żądaniem POST, uwierzytelnieniem bearer i plakietką 200 OK
API Walidacji Email

Weryfikuj w Czasie Rzeczywistym

Używaj prostego wywołania API do weryfikacji adresów podczas rejestracji, wzbogacania, przepływów AI agentów lub niestandardowych potoków przetwarzania list.

Strukturyzowany JSONOdpowiedź w czasie rzeczywistymWeryfikacja SMTP
Get Started for Free
API weryfikacji e-mail w czasie rzeczywistym zwraca odpowiedź 200 OK po próbie SMTP

Każdy tryb API weryfikacji, jeden endpoint

Każdy typ weryfikacji jest dostępny przez to samo REST API weryfikacji e-maili.

Darmowe API weryfikacji e-mail w trybach Pojedyncze, Wsad, Plik i integracja SDK

Weryfikacja pojedynczego e-maila

POST /verify — jedno wywołanie API weryfikacji e-maili w czasie rzeczywistym z odpowiedzią poniżej 3s. Zwraca status, dostarczalność, wynik jakości i flagi ryzyka w jednym obiekcie JSON.

Weryfikacja wsadowa

POST /verify/bulk — synchronicznie weryfikuje do 50 adresów na wywołanie API. Wszystkie wyniki wracają w jednej odpowiedzi API, według tego samego schematu, którego API weryfikacji e-maili w czasie rzeczywistym używa dla jednego adresu.

Asynchroniczne przetwarzanie plików

POST /verify/file — przesyła pliki CSV lub Excel do API w celu przetworzenia w tle. Wyniki są dostarczane przez wywołanie zwrotne webhook po zakończeniu zadania API.

Oficjalne SDK

W pełni typowane biblioteki klienckie API weryfikacji dla Python, Node.js, Go i PHP. Automatyczne ponawianie po błędzie, pełna obsługa błędów i identyczne typy odpowiedzi we wszystkich językach.

Obsługa webhooków w API weryfikacji

Odbieraj wyniki API asynchronicznie i przeszukuj historię wiadomości.

Webhook API weryfikacji e-mail dostarcza podpisane zdarzenie wywołania zwrotnego z plakietką Podpis

Dostawa asynchroniczna

Twórz webhooki

Zarejestruj endpointy HTTP, aby otrzymywać wyniki API natychmiast po ukończeniu zadania lub partii. API obsługuje niestandardowe dane, automatyczne ponawianie po błędzie oraz konfigurację dla zadania lub globalną.

  • Zdarzenia zakończenia zadania z podsumowaniem wyniku
  • Automatyczny retry przy nieudanej dostawie
  • Konfiguracja per job lub na poziomie konta

Historia wiadomości

Zapytania o wiadomości

Uzyskaj dostęp do pełnego dziennika zdarzeń webhook, aby pobierać wcześniejsze wyniki API, diagnozować błędy dostarczania lub odtwarzać pominięte powiadomienia. Zdarzenia API są przechowywane przez 30 dni.

  • Zapytania o zdarzenia według ID zadania lub zakresu dat
  • Odtwarzanie pominiętych lub nieudanych dostaw
  • 30-dniowe przechowywanie zdarzeń

Wewnątrz endpointu

Co API weryfikacji e-maili potwierdza przy każdym wywołaniu

API weryfikacji e-maili jest tak użyteczne, jak dowody stojące za polami odpowiedzi. To API zwraca fakty na poziomie skrzynki pocztowej, a nie opinię o składni przedstawioną jako werdykt.

Składnia i routing to tanie warstwy, a nie odpowiedź

Każde wywołanie API weryfikacji e-maili normalizuje adres, sprawdza jego strukturę i rozpoznaje rekordy MX domeny. Te dwie warstwy API są szybkie i nie obciążają odbiorcy, dlatego działają jako pierwsze i odrzucają oczywiste śmieci przed etapem SMTP.

API sprawdzające tylko składnię zatrzymuje się tutaj i uznaje wynik za prawidłowy. Na tym polega różnica między endpointem walidacji a bezpłatnym API weryfikacji e-maili, które dociera do samej skrzynki.

Na etapie SMTP API weryfikacji zasługuje na swoją nazwę

API nawiązuje rzeczywistą komunikację SMTP z serwerem odbiorczym i testuje ścieżkę odbiorcy. Nie wysyła treści wiadomości, nie klika łącza potwierdzającego i nic nie trafia do skrzynki tej osoby. Nasze bezpłatne API weryfikacji e-maili odczytuje odpowiedź serwera na tyle dokładnie, by odróżnić zaakceptowanego odbiorcę od trwałego odrzucenia.

To właśnie czyni je API weryfikacji e-maili w czasie rzeczywistym, a nie wyszukiwaniem DNS opatrzonym tekstem marketingowym. Dowód pochodzi z systemu, który faktycznie przyjmie lub odrzuci Twoją wiadomość.

Flagi ryzyka towarzyszą statusowi w tej samej odpowiedzi

Jeden obiekt JSON z API zawiera status dostarczalności, wynik jakości, poziom ryzyka, kody przyczyn oraz flagi adresu jednorazowego, konta funkcyjnego, catch-all i bezpłatnej poczty internetowej. Twoja aplikacja nie potrzebuje drugiego wywołania API, aby wyjaśnić wynik.

Flagi celowo znajdują się obok statusu. Akceptowany adres funkcyjny i akceptowana skrzynka osobista są dostarczalne, a tylko Twój produkt wie, który z nich pasuje do danego przepływu pracy.

Niejednoznaczne odpowiedzi pozostają niejednoznaczne

Greylisting, odroczenia po stronie dostawcy i limity żądań są normalne w skali API. W takich przypadkach bezpłatne API weryfikacji e-maili zwraca unknown, zamiast zmieniać wynik na deliverable lub invalid.

Logika ponawiania należy do Twojego kodu, a nie do ukrytego wnętrza endpointu. API, które po cichu zgaduje, usuwa jedyny sygnał potrzebny do decyzji o ponowieniu lub skierowaniu rekordu do sprawdzenia.

Pola odpowiedzi

Przełóż każdy status API weryfikacji na decyzję aplikacji

Odpowiedź API zaprojektowano tak, aby bezpośrednio sterowała logiką aplikacji. Każdy status odpowiada jednemu działaniu, a kody przyczyn API wyjaśniają przypadki graniczne.

deliverable — kontynuuj

Ścieżka odbiorcy przyjęła próbę podczas wywołania. Zaakceptuj rejestrację, zapisz kontakt lub ustaw wiadomość w kolejce, zgodnie z regułami zgody obowiązującymi w Twoim produkcie.

Bezpłatne API weryfikacji e-maili zwraca na darmowym poziomie to samo pole statusu co przy płatnym wolumenie, więc zachowanie testowane za darmowe kredyty jest tym samym, które wdrażasz.

undeliverable — odrzuć lub zapytaj ponownie

Trwały błąd zwrócony przez API oznacza, że adres spowoduje trwałe odbicie. W formularzu rejestracji pokaż pole ponownie wraz z kodem przyczyny API. W zadaniu w tle wyklucz rekord, zamiast usuwać pierwotną wartość.

Nigdy nie poprawiaj domeny automatycznie. API weryfikacji może wykazać, że adres nie działa, ale nie może ustalić, jaki adres dana osoba miała na myśli.

risky — zastosuj własne zasady

Risky oznacza, że skrzynka może przyjmować wiadomości, ale ma flagę istotną dla Twojego produktu. Przeczytaj kody przyczyn: dostawca adresów jednorazowych przy płatnej rejestracji to zupełnie inny problem niż adres funkcyjny w formularzu pomocy.

Zapisz zasady raz, w miejscu wywołania naszego bezpłatnego API weryfikacji e-maili, aby każda część produktu traktowała tę samą flagę API jednakowo.

unknown — ponów, nie odrzucaj

Dostawca odbiorczy przekazał API odpowiedź, która niczego nie potwierdza. Ustaw adres w kolejce do późniejszego wywołania API, zamiast blokować użytkownika lub zapisywać fałszywie negatywny wynik w bazie danych.

API weryfikacji e-maili w czasie rzeczywistym używane podczas rejestracji powinno łagodnie obsłużyć tę sytuację: przepuścić użytkownika, ponownie zweryfikować adres asynchronicznie i zadziałać na podstawie drugiego wyniku API.

Wzorce integracji

Gdzie wywoływać API weryfikacji e-maili w rzeczywistym systemie

Większość integracji API korzysta z tych samych trzech punktów styku. Właściwe umiejscowienie wywołania API ma większe znaczenie niż wybór SDK.

  1. 1

    W punkcie pozyskania danych

    Wywołaj API po przesłaniu adresu — podczas rejestracji, finalizacji zakupu, wysyłania formularza pozyskiwania leadów lub aktualizacji profilu. Weryfikacja, gdy dana osoba nadal jest na stronie, to jedyny moment, w którym może samodzielnie poprawić swoją literówkę, co jest najmocniejszym argumentem za bezpośrednim wywołaniem API.

    Po krótkim limicie czasu wywołanie nie powinno blokować działania. Odpowiedź bezpłatnego API weryfikacji e-maili zwykle przychodzi w ciągu jednej do trzech sekund, ale formularz nie powinien zgłaszać błędu z powodu wolnej odpowiedzi dostawcy odbiorczego.

  2. 2

    W potoku, który już przenosi Twoje dane

    Zadania synchronizacji CRM, procesy wzbogacania danych i etapy ETL to naturalne miejsca dla bezpłatnego API weryfikacji e-maili. Dodaj wywołanie API tam, gdzie rekordy już przepływają, a status, flagi i znacznik czasu sprawdzenia zapisuj jako pola.

    W przypadku plików zamiast pojedynczych rekordów API POST /verify/file przyjmuje CSV lub Excel i po zakończeniu zadania wywołuje Twój webhook, dzięki czemu wsadowe operacje API nie wymagają długotrwałego połączenia.

  3. 3

    W agentach i narzędziach AI

    MCP Server udostępnia nasze bezpłatne API weryfikacji e-maili w Claude Desktop i Cursor za pomocą języka naturalnego, a Agent Skills instaluje je jednym kliknięciem na platformach agentowych. Obie metody zwracają ten sam uporządkowany JSON co REST API.

    Ma to znaczenie dla niezawodności agenta: model nie musi analizować prozy, a narzędzie nie może uznać adresu za prawidłowy, gdy bazowe API zwróciło unknown.

  4. 4

    Bezpośrednio przed wysyłką

    Aktualność jest ważniejsza niż wolumen. Weryfikuj cennych odbiorców tuż przed wysyłką, zamiast ufać statusowi zapisanemu kilka miesięcy wcześniej, i ponownie sprawdzaj nieaktywne rekordy przed dodaniem ich do kampanii.

    Dla całej listy, Masowa weryfikacja e-maili uruchamia ten sam mechanizm dla pliku, więc nie musisz nadbudowywać logiki przetwarzania wsadowego nad endpointem czasu rzeczywistego.

Uczciwe ograniczenia

Cztery rzeczy, których API weryfikacji e-maili nie potwierdza

Odpowiedź API jest wiarygodna, ponieważ ma wąski zakres. Każda z poniższych kwestii należy do innego narzędzia lub zespołu, a nie do API weryfikacji.

Nie potwierdza tożsamości ani zgody

To, że skrzynka przyjmuje wiadomości, nie mówi nic o tym, kto nią zarządza, gdzie pracuje ani czy zgodził się na kontakt. Współdzielone aliasy, przekierowane adresy i nieaktualne dane wzbogacające mogą zwracać wynik deliverable z API przypisany do niewłaściwej osoby.

Do ustalania tożsamości używaj danych własnych, a zgodę przechowuj we własnym systemie ewidencji. Żadne API weryfikacji nie może dostarczyć żadnej z tych informacji.

Nie gwarantuje dostarczenia do skrzynki odbiorczej

Akceptacja SMTP opisuje ścieżkę odbiorcy w chwili wywołania API. To, czy kampania dotrze do skrzynki odbiorczej, zależy od reputacji nadawcy, uwierzytelnienia, treści i historii skarg — czynników po stronie nadawcy, których API nie obserwuje.

Weryfikacja usuwa błędy na poziomie adresu. Dostarczalność samej wiadomości to osobny proces z własnymi wskaźnikami.

Domeny catch-all pozostają niepewne

Domena catch-all akceptuje każdą część lokalną, dlatego żadne bezpłatne API weryfikacji e-maili nie może potwierdzić, że istnieje w niej konkretny odgadnięty adres. API zwraca tę flagę właśnie po to, aby Twój kod nie musiał tego wywnioskować.

Kieruj wyniki catch-all do sprawdzenia, zamiast zaliczać je do deliverable, szczególnie w listach B2B tworzonych na podstawie wzorców imion i nazwisk.

Wynik to obserwacja ze znacznikiem czasu

Każdego dnia skrzynki są zamykane, aliasy wycofywane, a domeny przenoszone. API raportuje stan prawdziwy w chwili wywołania, a ta informacja zaczyna się starzeć od momentu odpowiedzi API.

Zapisuj czas sprawdzenia obok statusu, aby systemy na dalszych etapach mogły zdecydować, kiedy dowód jest zbyt stary, by na nim działać.

Powiązane rozwiązania

Jak API weryfikacji łączy się z resztą platformy

Ten sam mechanizm jest dostępny przez kilka interfejsów API. Wybór właściwego zależy zwykle od tego, kto wysyła zapytanie, a nie od dokładności.

Jeden adres, ręcznie

Gdy ktoś potrzebuje sprawdzić jeden wynik zamiast automatyzować tysiące, Weryfikator e-maili uruchamia w przeglądarce identyczny potok SMTP i pokazuje wszystkie flagi zwracane przez API.

To najszybszy sposób na wstępne sprawdzenie adresu przed napisaniem kodu korzystającego z API weryfikacji e-maili.

Cały plik naraz

Gdy pracujesz z listą, a nie strumieniem, Czyszczenie listy e-maili stosuje te same reguły do każdego wiersza i zachowuje przyczyny w eksporcie.

Pliki i wywołania API korzystają z jednego mechanizmu, więc wiersz oczyszczony wsadowo i adres sprawdzony przez API weryfikacji nie mogą zwrócić sprzecznych wyników.

Ujęcie skoncentrowane na walidacji

API walidacji e-maili opisuje ten sam endpoint dla zespołów, które wyszukują walidację zamiast weryfikacji, przedstawiając szczegóły integracji z tej perspektywy.

Endpoint, schemat i dowody SMTP są identyczne; różni się tylko sposób przedstawienia dokumentacji.

Często zadawane pytania

1. Jak szybkie jest API weryfikacji e-maili?

Wyniki API z pamięci podręcznej wracają w mniej niż 200ms. Pełna weryfikacja SMTP trwa średnio 1–3 sekundy, dzięki czemu API nadaje się do weryfikacji e-maili w formularzu w czasie rzeczywistym. API obsługuje do 6,000 pojedynczych weryfikacji i 1,500 żądań wsadowych na minutę.

2. Jak zintegrować API weryfikacji e-maili?

API weryfikacji używa standardowych wywołań REST i odpowiedzi JSON. Oficjalne SDK są dostępne dla Python, Node.js, Go i PHP. Większość integracji API zajmuje mniej niż 30 minut. MCP Server i Agent Skills nie wymagają kodowania — wystarczy je zainstalować, aby API weryfikacji e-maili w czasie rzeczywistym działało w każdym obsługiwanym kliencie AI.

3. Ile kosztuje API weryfikacji e-maili?

Plan Starter kosztuje $20 za 20,000 kredytów po $0.001 za e-mail — bez opłat miesięcznych, płacisz tylko za użycie. Przy 1M kredytów cena wolumenowa spada do $0.00035 za e-mail. Bezpłatny poziom API weryfikacji e-maili zapewnia 20 darmowych kredytów za każdy dzień logowania, do 600 miesięcznie, bez karty kredytowej.

4. Co zawiera każda odpowiedź API weryfikacji?

Każda odpowiedź API zawiera status weryfikacji (deliverable, undeliverable, risky lub unknown), wynik jakości od 0–100, poziom ryzyka i kody przyczyn. Obejmuje też flagę jednorazowego e-maila, flagę konta funkcyjnego, wykrywanie catch-all i sugestie korekty literówek.

5. Czy API weryfikacji jest bezpieczne?

Wszystkie żądania API używają HTTPS. Każde wywołanie API wymaga uwierzytelnienia kluczem API, a dla dodatkowej ochrony dostępna jest biała lista adresów IP. BillionVerify jest w pełni zgodny z GDPR i CCPA oraz automatycznie usuwa dane po przetworzeniu.

6. Jak agenci AI i LLM korzystają z tego API weryfikacji?

Agenci AI łączą się przez MCP Server (język naturalny w Claude i Cursor), gotowe Agent Skills (instalacja jednym kliknięciem dla Claude i Manus) albo bezpośrednie wywołania REST z LangChain, CrewAI lub dowolnego SDK Anthropic albo OpenAI. Każda metoda korzysta z tego samego API weryfikacji e-maili i zwraca ten sam uporządkowany JSON — bez konieczności przekształcania odpowiedzi.

7. Jaka jest różnica między email validation API a email verification API?

API walidacji e-maili i API weryfikacji e-maili zwykle oznaczają ten sam endpoint — sprawdzający, czy adres jest prawdziwy i dostarczalny. BillionVerify używa weryfikacji na poziomie SMTP, potwierdzając istnienie skrzynki na serwerze odbiorczym, a nie tylko walidacji DNS lub składni. Pojedynczy endpoint /verify zwraca w jednej odpowiedzi JSON status, wynik jakości, flagę adresu jednorazowego, flagę konta funkcyjnego i wykrycie catch-all.

API weryfikacji e-maili

Uzyskaj klucz API

Jeden endpoint dla każdego typu weryfikacji. MCP Server i Agent Skills w zestawie. Bezpłatny poziom API weryfikacji e-maili zapewnia 20 kredytów za każdy dzień logowania, do 600 miesięcznie, bez karty kredytowej.

600 darmowych kredytów miesięcznie · Natywna integracja MCP Server · Bez karty kredytowej

99.9%
Dokładność
Real-time
Szybkość API
$0.00014
Za e-mail
600/mo
Zawsze darmowe