API weryfikacji adresów e-mail

API weryfikacji i walidacji adresów e-mail zaprojektowane
dla Deweloperów przez Deweloperów

Bouncer Email Verification API jest prostym i jednocześnie potężnym sposobem na wzmocnienie Twojego rozwiązania informatycznego o najbardziej precyzyjną i wysokowydajną weryfikację adresów e-mail. Wiele punktów końcowych, zarówno synchronicznych jak i asynchronicznych, zaspokoi Twoje najbardziej wyrafinowane potrzeby w zakresie weryfikacji adresów e-mail. Ponieważ jest to rozwiązanie super bezpieczne i solidne, dane Twoje i Twoich klientów są bezpieczne.

💪

Łatwy do zintegrowania

Zintegruj się w kilka godzin z pomocą naszego zespołu.

🤝

Łatwy we współpracy

Drużyna, która naprawdę pomoże.

Spis treści

• Generowanie klucza API
• Odniesienie do API
• Uwierzytelnianie
• JSON
• Synchroniczne API weryfikacji w czasie rzeczywistym
• Asynchroniczne API masowej weryfikacji
• Dostępne Kredyty
• Obsługa błędów
• Wsparcie

Aby wygenerować swój klucz API przejdź do Tutaj albo:

• założyć konto Bouncera Tutaj,
• kliknij na w menu po lewej stronie,
• Kliknij Generowanie klucza API Guzik.

API Reference jest dostępne Tutaj.
Bouncer REST API Reference dostarcza wszystkich informacji o dostępnych punktach końcowych, ich parametrach, schematach odpowiedzi json i przykładach odpowiedzi.
Pozwala również w łatwy i bezpieczny sposób przetestować wszystkie punkty końcowe. Wystarczy podać swój klucz API i dobrze się bawić, testując nasze API weryfikacji poczty e-mail.

Wszystkie połączenia do API Bouncera muszą być wykonywane przy użyciu HTTPS.
Mimo, że Bouncer API obsługuje podstawowe uwierzytelnianie, zdecydowanie zalecamy użycie x-api-key w metodzie uwierzytelniania nagłówkowego.
Dostępne są następujące metody uwierzytelniania:

x-api-klucz w nagłówku

Uwierzytelnienie "Basic" z kluczem api jako hasłem

W każdym przypadku, gdy wymagany jest organ wnioskujący, powinien on być sformatowany jako JSON oraz rodzaj zawartości wniosek/jon powinien być określony.

Możesz użyć API weryfikacji poczty elektronicznej w czasie rzeczywistym w Bouncer, aby sprawdzić adresy e-mail w momencie wpisywania i zaimplementować je do swoich formularzy.
Jest to metoda pełnej weryfikacji i walidacji poczty elektronicznej - nie tylko sprawdza składnię i domenę adresu, ale także kontakty leżące u podstaw serwerów SMTP w celu sprawdzenia dostarczalności adresów e-mail.
Dzięki API weryfikacji poczty elektronicznej w czasie rzeczywistym Bouncer zwraca najlepsze możliwe wyniki, które są dostępne w ciągu X sekund określonych przez klienta (domyślnie - 10 sekund, maksymalnie - 30 sekund).
Metoda synchroniczna, w postaci punktu końcowego API weryfikacji poczty w czasie rzeczywistym, jest zalecana, gdy szybkość weryfikacji ma wartość, ponieważ zazwyczaj metoda ta zwraca o 5% więcej "nieznanych" wyników niż pełna integracja za pomocą Batch Email Verification API.

Przykład użycia

Limity

Interfejs API weryfikacji poczty elektronicznej w czasie rzeczywistym jest domyślnie ograniczony do 100 żądań na minutę. Jeśli Twój przypadek użycia wymaga wyższych limitów, poinformuj nas o tym.

Jeśli potrzebujesz zweryfikować wiele adresów e-mail w jednej partii, możesz użyć naszego Batch Email Verification API.
Infrastruktura rozproszona Bouncera zapewni uzyskanie najlepszych możliwych wyników i powtórną weryfikację w przypadku, gdy jest ona wymagana. Metoda ta jest zalecana, gdy jakość weryfikacji ma wartość, ponieważ charakteryzuje się najlepszą precyzją walidacji poczty elektronicznej i najniższą możliwą ilością "nieznanych" wyników.
Ustawienia domyślne pozwalają naszym klientom na weryfikację 100 tys. adresów e-mail na godzinę, jednak jeśli Twój przypadek użycia wymaga większej przepustowości, poinformuj nas o tym, a my będziemy w stanie dostosować Twoją konfigurację.

Używanie API do masowej weryfikacji adresów e-mail (Batch Email Verification)

Możesz zweryfikować jeden lub wiele adresów e-mail za pomocą Batch Email Verification API, w trybie offline.
Aby skorzystać z tej metody, należy podać tablicę adresów e-mail, na przykład z nazwiskami, jeśli to konieczne (opcjonalnie):

Upewnij się, że przechowujesz requestId, ponieważ będzie to konieczne do sprawdzenia statusu i uzyskania wyników dla żądania.

Przepływ integracyjny

Istnieją 2 sposoby integracji z Batch Email Verification API:

• używając statusowego punktu końcowego, lub
• za pomocą parametru wywołania zwrotnego.

Korzystanie z punktu końcowego statusu

Korzystanie z wywołań zwrotnych

Zalecenie dotyczące wielkości partii

Pojedyncza partia może przetwarzać do 250.000 e-maili, a zalecana wielkość to 1000-10000 e-maili. Równolegle przetwarzanych będzie do 25 partii.

Limity

Batch Email Verification API jest domyślnie ograniczone do 200 zgłoszeń na minutę.

Usuń dane partii

Ponieważ Bouncer jest w pełni zgodny z GDPR, zapewniamy również punkt końcowy do trwałego usunięcia Twoich żądań. Należy pamiętać, że po użyciu, wyniki związane z żądaniami zostaną utracone.
Aby usunąć swoje dane użytkownika:

Aby sprawdzić dostępne saldo, możesz użyć tego punktu końcowego.

API Bouncera korzysta ze standardowych błędów HTTP, aby wskazać powodzenie lub porażkę żądania. Seria 2xx kodów odpowiedzi wskazuje powodzenie, 4xx wskazuje błąd po stronie klienta, a 5xx błąd wskazuje błąd po stronie serwera. Oto kody odpowiedzi HTTP, które wykorzystuje API: