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

API Walidacji Email

Jeden endpoint dla każdego typu weryfikacji. API walidacji e-mail w czasie rzeczywistym ze sprawdzaniem SMTP, ustrukturyzowanymi odpowiedziami JSON oraz natywną integracją MCP i Agent Skills.

Konsola Email Validation API z żądaniem POST, kartą klucza API, plakietką 200 OK i odpowiedzią JSON
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 walidacji e-mail w czasie rzeczywistym zwraca odpowiedź 200 OK po sprawdzeniu SMTP

Każdy tryb API walidacji, jeden endpoint

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

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

Weryfikacja pojedynczego e-maila

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

Weryfikacja wsadowa

POST /verify/bulk — synchronicznie waliduje do 50 adresów w jednym wywołaniu API. Wszystkie wyniki wracają w jednej odpowiedzi API, w tym samym schemacie co walidacja pojedyncza.

Asynchroniczne przetwarzanie plików

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

Oficjalne SDK

Typowane biblioteki klienckie bezpłatnego API walidacji e-mail 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 walidacji

Odbieraj wyniki API asynchronicznie i przeglądaj historię wiadomości.

Webhook API walidacji e-mail dostarcza zdarzenie wywołania zwrotnego z plakietką Ponów

Asynchroniczne dostarczanie

Tworzenie webhooków

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

  • Zdarzenia ukończenia zadania z podsumowaniem wyników
  • Automatyczne ponowienie przy nieudanym dostarczeniu
  • Konfiguracja per zadanie lub na poziomie konta

Historia wiadomości

Przeglądanie wiadomości

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

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

Kontrakt odpowiedzi

Co zwraca API walidacji e-mail, pole po polu

Większość zespołów wdraża API walidacji, aby zastąpić wyrażenie regularne. Zmiana opłaca się tylko wtedy, gdy odpowiedź API zawiera więcej informacji niż zastępowana wartość logiczna.

status to pole, według którego powinien rozgałęziać się kod

API zwraca jeden z czterech statusów: dostarczalny, niedostarczalny, ryzykowny lub nieznany. Istnieją cztery stany, ponieważ rzeczywistość ma cztery stany, a każde API walidacji, które sprowadza je do prawdy i fałszu, zmusza wszystkich wywołujących do samodzielnego odtworzenia brakujących niuansów.

Najpierw rozgałęziaj logikę według pola status. Wszystko inne w odpowiedzi bezpłatnego API walidacji e-mail wyjaśnia ten status, zamiast go zastępować.

wynik i poziom ryzyka służą do ustalania kolejności, nie do blokowania

Wynik jakości od 0 do 100 i poziom ryzyka pozwalają sortować kolejkę, ustalać priorytet dalszego kontaktu sprzedażowego lub dostrajać próg dla każdego miejsca użycia. Są to pochodne pola API, więc traktuj je jako wskazówki do ustalania kolejności, a nie jako werdykt API.

Blokowanie na podstawie samego wyniku prowadzi do przypadkowego odrzucania dobrych klientów. Blokuj według statusu, a kolejność ustalaj według wyniku.

kody przyczyn ułatwiają debugowanie API

Każda odpowiedź API inna niż dostarczalna zawiera przyczynę możliwą do odczytu maszynowego. Nieprawidłowa składnia, brak trasy pocztowej, odrzucenie skrzynki i odroczenie przez dostawcę to różne problemy wymagające różnych rozwiązań, a nasze bezpłatne API walidacji e-mail nazywa każdy z nich zamiast zwracać ogólny błąd.

Rejestruj kod przyczyny z API, nie opis. Jest stabilny między wersjami i pozwala odpowiedzieć po wielu miesiącach na zgłoszenie dotyczące konkretnego adresu.

flagi logiczne opisują adres, nie jego dostarczalność

Flagi adresu jednorazowego, konta roli, Catch-All i bezpłatnej osobistej skrzynki pocztowej są zwracane niezależnie. Adres może być w pełni dostarczalny i jednocześnie mieć trzy z nich, co jest właśnie takim przypadkiem, którego nie potrafi wyrazić walidator składni, a API potrafi.

Na tym polega praktyczna różnica między API walidacji e-mail w czasie rzeczywistym a sprawdzaniem formatu: sprawdzenie formatu potwierdza prawidłową budowę ciągu, a API mówi, czym naprawdę jest adres.

Migracja

Przejście z walidatora składni na rzeczywiste API walidacji

Zespoły zwykle mają już w kodzie wyrażenie regularne lub wywołanie biblioteki. Migracja do API jest niewielka, ale wymaga zmiany trzech nawyków.

Przestań traktować format jak odpowiedź

Wyrażenie regularne dowodzi, że ciąg może być adresem. To bezpłatne API walidacji e-mail potwierdza, że serwer pocztowy obecnie go akceptuje. Możesz zachować wyrażenie regularne jako tanią wskazówkę po stronie klienta, ale nie pozwalaj mu decydować, czy rekord jest prawidłowy.

W praktyce oznacza to usunięcie gałęzi, według której prawidłowy format pozwala zapisać dane, i zastąpienie jej gałęzią opartą na polu status odpowiedzi API.

Ustaw limit czasu i fallback dla API

Wywołanie sieciowe może działać wolno, gdy wolno odpowiada dostawca odbiorczy. Ustaw dla API limit czasu akceptowalny dla formularza i z góry zdecyduj, co stanie się po jego przekroczeniu: zwykle należy przyjąć adres, oznaczyć go jako niezweryfikowany i sprawdzić ponownie późniejszym wywołaniem API.

API walidacji e-mail w czasie rzeczywistym nigdy nie powinno powodować niepowodzenia rejestracji. Traktuj adres jako niezweryfikowany, a nie odrzucony.

Przechowuj wynik jako dane, nie jako filtr

Zapisuj w rekordzie status API, kod przyczyny, flagi i znacznik czasu sprawdzenia. Zespół, który przechowuje tylko uproszczoną wartość logiczną, nie wyjaśni decyzji o wykluczeniu po trzech kolejnych kampaniach ani nie odróżni świeżych danych API od nieaktualnych.

Przechowywanie pełnej odpowiedzi API pozwala też zmienić zasady bez ponownej weryfikacji: fakty pozostają, a zmienia się tylko reguła, która je odczytuje.

Obsłuż stan nieznany świadomie i tylko raz

Stan nieznany nie jest błędem API ani niepowodzeniem. Oznacza, że dostawca odbiorczy nie udzielił jednoznacznej odpowiedzi. Zdefiniuj strategię ponowień w jednym miejscu — kolejkę, opóźnienie i maksymalną liczbę prób API — zamiast rozpraszać doraźne ponowienia po całej bazie kodu.

Większość nieznanych wyników rozstrzyga się przy późniejszym wywołaniu API, dlatego nasze bezpłatne API walidacji e-mail raportuje je uczciwie, zamiast zgadywać.

Powierzchnia integracji

Cztery sposoby wywoływania API walidacji e-mail

Jeden endpoint, cztery formy API. Wybierz według rozmiaru i opóźnienia zadania, nie według preferencji.

  1. 1

    Jeden adres, synchronicznie

    POST /verify przyjmuje jeden adres i zwraca pełny JSON w ciągu od jednej do trzech sekund. Jest to ścieżka API walidacji e-mail w czasie rzeczywistym używana przez formularze rejestracji, proces płatności i edycję profilu.

    Ponieważ jest to pojedyncze wywołanie API bez cyklu życia zadania, stanowi również najłatwiejszy obszar do testowania przed zbudowaniem czegoś większego.

  2. 2

    Do 50 adresów w jednym wywołaniu

    POST /verify/bulk synchronicznie weryfikuje do 50 adresów i zwraca je w tym samym schemacie. Użyj go, gdy strona lub zadanie w naturalny sposób obsługuje po kilka rekordów naraz.

    Limit partii to twarda granica API, a nie miękki limit. Większe payloady są odrzucane z jasnym błędem API wskazującym endpoint plikowy, więc nic nie zmienia się po cichu w powolne żądanie.

  3. 3

    Pliki, asynchronicznie

    POST /verify/file przyjmuje CSV lub Excel, przetwarza plik w tle i wywołuje webhook po ukończeniu zadania API. Podczas przetwarzania dużego pliku żadne połączenie nie musi pozostawać otwarte.

    Dla obciążenia w formie listy, a nie wywołań API, Masowa weryfikacja e-mail korzysta z tego samego silnika dla przesłanego pliku, z deduplikacją i eksportem CSV.

  4. 4

    Z agentów AI i klientów MCP

    MCP Server udostępnia to samo API walidacji e-mail w Claude Desktop i Cursor za pomocą języka naturalnego, a Agent Skills instalują je na platformach agentowych jednym kliknięciem. Obie metody zwracają taki sam ustrukturyzowany JSON jak REST API.

    Dzięki temu zachowanie agenta pozostaje uczciwe: narzędzie nie może przedstawić wyniku nieznanego jako prawidłowego, ponieważ agent odczytuje odpowiedź bezpłatnego API walidacji e-mail.

Zakres

Co API walidacji świadomie pozostawia Tobie

API jest celowo wąskie. Każdy poniższy punkt jest rzeczywistym wymaganiem — ale należy do innej części Twojego systemu, a nie do API walidacji.

Zgoda i wykluczenia

Nasze bezpłatne API walidacji e-mail może stwierdzić, że adres przyjmuje pocztę. Nie może ustalić, czy dana osoba zgodziła się na kontakt, i nie odczytuje Twojej listy wykluczeń.

Przechowuj zgodę we własnym systemie źródłowym i sprawdzaj ją przed wywołaniem API, nie po nim.

Tożsamość i zatrudnienie

Dostarczalny adres firmowy nie dowodzi, że wskazana osoba go kontroluje ani że nadal tam pracuje. Aliasy, współdzielone skrzynki i nieaktualne dane wzbogacające regularnie obalają to założenie.

Do potwierdzania tożsamości używaj danych własnych. To bezpłatne API walidacji e-mail zwraca dowody dotyczące skrzynki, nie człowieka.

Umieszczenie w skrzynce odbiorczej

Akceptacja SMTP jest faktem po stronie odbiorcy. To, czy wiadomość trafi do skrzynki odbiorczej, zależy od reputacji nadawcy, uwierzytelniania, treści i historii skarg, a żadnej z tych rzeczy API nie może zaobserwować.

Poprawiaj jakość adresów za pomocą API, a umieszczenie wiadomości przez działania po stronie nadawcy i monitoring, którego API nie może wykonać za Ciebie.

Aktualność

Każda odpowiedź API opisuje moment wywołania. Skrzynki są zamykane, aliasy wycofywane, a domeny migrowane, dlatego zapisany wynik API traci aktualność niezależnie od tego, czy ktoś odczyta go ponownie.

Weryfikuj ponownie według harmonogramu dopasowanego do szybkości zmian danych i pozwól, aby znacznik czasu sprawdzenia automatycznie sterował tą decyzją.

Powiązane obszary

Miejsce API walidacji e-mail wśród innych narzędzi

Ten sam silnik działa za kilkoma obszarami API. Wybór zależy od tego, kto pyta i ilu adresów dotyczy zadanie.

Ujęcie tego samego endpointu jako weryfikacji

API weryfikacji e-mail dokumentuje ten sam endpoint dla zespołów, które szukają weryfikacji zamiast walidacji, i dokładniej wyjaśnia dowody SMTP.

Schemat, kredyty i dokładność są identyczne — różni się tylko sposób ujęcia dokumentacji.

Narzędzie przeglądarkowe dla jednego adresu

Gdy ktoś chce obejrzeć pojedynczy wynik zamiast cokolwiek automatyzować, Weryfikator e-mail uruchamia w przeglądarce ten sam proces i pokazuje każdą flagę zwracaną przez API.

To najszybszy sposób na potwierdzenie działania silnika przed napisaniem kodu korzystającego z bezpłatnego API walidacji e-mail.

Podstawowa walidacja bez SMTP

Jeśli wymagania naprawdę obejmują tylko format i routing poczty, Walidator e-mail zatrzymuje się na składni i MX, nigdy nie zużywając sprawdzenia SMTP.

Używaj go do taniego wstępnego filtrowania, a API walidacji e-mail w czasie rzeczywistym zachowaj dla rekordów, przy których zwrot wiadomości rzeczywiście wiązałby się z kosztem.

Często zadawane pytania

1. Jak szybkie jest API walidacji e-mail?

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

2. Jak zintegrować API walidacji e-mail?

API walidacji 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ą kodu — wystarczy jedna instalacja, aby bezpłatne API walidacji e-mail działało w każdym obsługiwanym kliencie AI.

3. Ile kosztuje API walidacji e-mail?

Plan Starter kosztuje $20 za 20,000 kredytów, czyli $0.001 za e-mail — bez opłat miesięcznych, płacisz tylko za użycie. Ceny wolumenowe spadają do $0.00035 za e-mail przy 1M kredytów. Bezpłatny poziom API walidacji e-mail zapewnia 20 darmowych kredytów za każdy dzień logowania, do 600 miesięcznie, bez karty kredytowej.

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

Każda odpowiedź API zawiera status walidacji (dostarczalny, niedostarczalny, ryzykowny lub nieznany), wynik jakości 0–100, poziom ryzyka i kody przyczyn. Zawiera też flagę adresu jednorazowego, flagę konta roli, wykrywanie Catch-All oraz sugestie korekty literówek.

5. Czy API walidacji jest bezpieczne?

Wszystkie żądania API używają HTTPS. Każde wywołanie API wymaga uwierzytelnienia kluczem API, a dodatkowe zabezpieczenie zapewnia biała lista 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 walidacji?

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 bądź OpenAI. Każda ścieżka korzysta z tego samego API walidacji e-mail i zwraca ten sam ustrukturyzowany JSON — bez potrzeby transformacji odpowiedzi.

7. Jaka jest różnica między API walidacji e-mail a API weryfikacji e-mail?

API walidacji e-mail i API weryfikacji e-mail zwykle oznaczają ten sam endpoint — sprawdzający, czy adres jest prawdziwy i dostarczalny. BillionVerify wykonuje kontrole na poziomie SMTP, potwierdzając istnienie skrzynki na serwerze odbiorczym, zamiast ograniczać się do walidacji DNS lub składni. Pojedynczy endpoint /verify zwraca status, wynik jakości, flagę adresu jednorazowego, flagę konta roli i wykrywanie Catch-All w jednej odpowiedzi JSON.

API Walidacji Email

Uzyskaj klucz API

Jeden endpoint dla każdego typu walidacji. MCP Server i Agent Skills w zestawie. Bezpłatny poziom API walidacji e-mail 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