API do walidacji email w czasie rzeczywistym dla formularzy rejestracji
Waliduj adresy w chwili, gdy użytkownicy je wysyłają. Jedno wywołanie sprawdza serwer pocztowy i to, czy skrzynka istnieje. Dostajesz też oznaczenia adresów jednorazowych i funkcyjnych, więc to ty decydujesz, co przyjąć. Nasze API do walidacji email zatrzymuje złe dane, zanim trafią do twojej bazy, i blokuje fałszywe konta.
// 1. Receive submitted form data
const { email } = req.body;
// 2. Validate via API
const { data } = await checkEmail(email);
// 3. Make real-time form decision
if (data.status === 'undeliverable') {
return res.status(400).json({ error: 'Please enter a valid, active email address.' });
}
if (data.details.attributes.disposable) {
return res.status(400).json({ error: 'Temporary or disposable emails are not allowed.' });
}
// 4. Proceed with account registration
await createUser({ email });1000 darmowych kredytów, bez karty. Kredyty nigdy nie wygasają.
Dlaczego sam regex to jeszcze nie walidacja e-mail
Wyrażenie regularne sprawdza tylko budowę ciągu znaków: czy jest znak @, czy format domeny wygląda wiarygodnie i czy znaki mieszczą się w standardowym zakresie ASCII. Regex mówi tylko, czy wpis wygląda jak adres e-mail. Nie mówi, czy ktoś może pod nim odbierać wiadomości.
Adres user@example.com albo asdf12345@gmail.com przejdzie przez każdy regex zgodny z RFC. Mimo to jedna domena może nie mieć aktywnych serwerów pocztowych, a druga skrzynka może nie istnieć.
Nasze API do walidacji email z odpowiedzią JSON robi znacznie więcej niż wyrażenia regularne. W jednym zapytaniu sprawdza rekordy DNS, wyszukuje hosty MX, łączy się z docelowym serwerem pocztowym, aby sprawdzić odpowiedź skrzynki, i porównuje domenę z obszernymi listami domen jednorazowych.
Sztywne wzorce regex powodują też błędne odrzucenia. Własne wyrażenia często odrzucają rzadsze domeny najwyższego poziomu, takie jak .studio czy .cloud, prawidłowe znaki narodowe albo poprawne adresy z nietypową interpunkcją. Nasze API automatycznie obsługuje całą składnię RFC 5322, więc nie musisz utrzymywać w kodzie zawodnych bibliotek regex.
Test składni
Wyłapuje proste literówki, brak domeny najwyższego poziomu, niedozwoloną interpunkcję i spacje, zanim zostanie wykonane jakiekolwiek zapytanie sieciowe.
Weryfikacja DNS i MX
Sprawdza, czy domena jest zarejestrowana, i wyszukuje skonfigurowane serwery pocztowe, które mogą przyjmować wiadomości.
Test skrzynki
Łączy się bezpośrednio ze zdalnym serwerem pocztowym, aby potwierdzić, czy konkretna skrzynka istnieje i może odbierać pocztę.
Co blokować, co oznaczać, a co przepuszczać przy rejestracji
Różne firmy mają różne wymagania przy rejestracji. Firmowy SaaS B2B może wymagać adresów firmowych, a aplikacja społecznościowa dla konsumentów chętnie przyjmie prywatne adresy Gmail. Oto zalecana tabela decyzji oparta na prawdziwych atrybutach odpowiedzi API:
| Wynik API | Warunek pola | Co powinien zrobić formularz |
|---|---|---|
| Nieprawidłowy | status === "undeliverable" | Zablokuj od razu. Pokaż komunikat: „Podaj prawidłowy, aktywny adres e-mail.” |
| Jednorazowy | details.attributes.disposable === true | Zablokuj albo poproś o inny adres. Pokaż komunikat: „Tymczasowe adresy e-mail są niedozwolone.” |
| Adres funkcyjny | details.attributes.role_account === true | Przepuść, ale oznacz w formularzach B2B. Powiadom opiekunów klientów albo przekaż adres do ogólnej puli leadów. |
| Darmowa poczta | details.attributes.free_email === true | Przepuść w aplikacjach B2C. W formularzach demo i okresu próbnego B2B wymagaj firmowego adresu. |
| Catch-all | details.attributes.catch_all === true | Sprawdź catch_all_verdict: jeśli „valid”, przepuść; jeśli „invalid”, zablokuj; jeśli null, pozwól na rejestrację. |
| Nieznany | status === "unknown" | Przyjmij i sprawdź ponownie później (kredyt jest zwracany). Przy braku odpowiedzi przepuszczaj, aby nigdy nie blokować prawdziwych użytkowników. |
Dodaj walidację e-mail do formularza rejestracji
Wykonaj te cztery kroki, aby bezpiecznie wdrożyć walidację w czasie rzeczywistym. Zapytania wymagają twojego prywatnego klucza API, więc uruchamiaj test z serwera backendu.
Dlaczego wzorzec fail-open jest ważny: formularze rejestracji są wrażliwe na opóźnienia. Jeśli zewnętrzne wywołanie API ma opóźnienie sieciowe, zablokowanie formularza może kosztować cię prawdziwego klienta. Krótki limit czasu i automatyczne przepuszczenie rejestracji sprawiają, że prawdziwi użytkownicy nie są odrzucani. W tym czasie backend dodaje adres do kolejki na późniejszy test w tle.
Formularz wysyła dane do backendu
Gdy odwiedzający wysyła dane rejestracji, przeglądarka przesyła adres e-mail do endpointu twojej aplikacji.
Backend wywołuje API do walidacji
Twój serwer wysyła synchroniczne zapytanie POST do Giggal z prywatnym kluczem zapisanym w zmiennej środowiskowej.
Backend stosuje tabelę decyzji
Odczytaj atrybuty JSON. Jeśli adres jest jednorazowy albo niedostarczalny, zwróć do przeglądarki jasny komunikat o błędzie.
Fail-open przy przekroczeniu czasu
Jeśli komunikacja z API przekroczy limit czasu, przepuść rejestrację i dodaj do kolejki zadanie w tle, które zweryfikuje adres później.
Przykłady kodu wdrożenia
// server.js (Express Route)
const timeoutMs = 5000; // adjust to what your form can tolerate
app.post('/api/signup', async (req, res) => {
const { email, password } = req.body;
try {
const apiRes = await fetch('https://api.giggal.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.GIGGAL_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ email }),
signal: AbortSignal.timeout(timeoutMs), // fail-open timeout
});
const result = await apiRes.json();
if (result.success) {
const { status, details } = result.data;
// Decision checks
if (status === 'undeliverable') {
return res.status(400).json({ error: 'This email address does not exist.' });
}
if (details.attributes.disposable) {
return res.status(400).json({ error: 'Disposable email addresses are not accepted.' });
}
}
} catch (err) {
// Fail open: log timeout and let user proceed
console.warn('Email check timed out, failing open:', err.message);
}
// Create user in database
const user = await db.users.create({ email, password });
return res.json({ success: true, userId: user.id });
});# app.py (Flask Route)
import os, requests
from flask import Flask, request, jsonify
app = Flask(__name__)
timeout_seconds = 5 # adjust to what your form can tolerate
@app.route("/api/signup", methods=["POST"])
def signup():
email = request.json.get("email")
try:
resp = requests.post(
"https://api.giggal.ai/v1/verify",
headers={"Authorization": f"Bearer {os.environ['GIGGAL_API_KEY']}"},
json={"email": email},
timeout=timeout_seconds # fail open on timeout
)
data = resp.json().get("data", {})
if data.get("status") == "undeliverable":
return jsonify({"error": "Email address is invalid."}), 400
if data.get("details", {}).get("attributes", {}).get("disposable"):
return jsonify({"error": "Disposable emails are prohibited."}), 400
except requests.exceptions.RequestException:
# Fail open: proceed with signup on timeout
pass
# Complete user registration
return jsonify({"success": True})// Frontend form submit handler
const form = document.querySelector('#signup-form');
form.addEventListener('submit', async (e) => {
e.preventDefault();
const email = document.querySelector('#email-input').value;
const res = await fetch('/api/signup', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ email }),
});
const payload = await res.json();
if (!res.ok) {
showFormError(payload.error); // Show friendly user feedback
} else {
redirectToDashboard();
}
});Ważne: nigdy nie wywołuj endpointu API Giggal bezpośrednio ze skryptów po stronie klienta. Trzymaj dane uwierzytelniające na swoim serwerze.
Zatrzymaj jednorazowe i fałszywe rejestracje
Tymczasowe skrzynki zaburzają analitykę produktu, zużywają limity darmowych okresów próbnych i nigdy nie zamieniają się w płacących klientów. Nasza usługa stale monitoruje i oznacza rejestracje o wysokim ryzyku.
Jednorazowe skrzynki
Sprawdzane w naszym aktualnym rejestrze ponad 100 000 tymczasowych domen. Dowiedz się, jak rozpoznajemy jednorazowe skrzynki, w naszym narzędziu do sprawdzania jednorazowych adresów e-mail.
Wykrywanie adresów z plusem
Oznacza aliasy utworzone z tagiem plus (user+trial@domain.com), dzięki czemu jedna osoba nie założy kilku kont próbnych.
Wykrywanie skrzynek no-reply
Wykrywa skrzynki nadawcze i automatyczne, które odrzucają przychodzącą korespondencję. Użytkownicy nie zarejestrują się więc adresem, z którym nie da się komunikować.
Nie poprawiaj literówek automatycznie
Nigdy nie zmieniaj po cichu tego, co wpisał użytkownik (na przykład automatycznie z gnail.com na gmail.com). Jeśli adres nie przejdzie walidacji, pokaż użytkownikowi jasny komunikat z prośbą o sprawdzenie wpisu. Ciche poprawianie grozi tym, że link aktywacyjny albo rachunek trafi do niewłaściwej osoby.
Gdzie walidować adresy e-mail w czasie rzeczywistym
Waliduj adresy e-mail wszędzie tam, gdzie użytkownicy wysyłają formularze w twoim produkcie.
Formularze rejestracji użytkowników
Zapobiegaj spamowi przy rejestracji i pomóż, by e-maile powitalne i linki weryfikacyjne trafiały do aktywnych skrzynek.
Zamówienia w sklepie internetowym
Zadbaj, aby powiadomienia o wysyłce, rachunki i potwierdzenia zamówień docierały do klientów bez błędów dostarczenia.
Zapytania o demo i kontakt
Odfiltruj fałszywe zgłoszenia od konkurencji i sprawdź domeny firm, zanim przekażesz kontakty handlowcom.
Zapisy do newslettera
Chroń reputację domeny, z której wysyłasz newsletter. Odrzucaj błędne wpisy i rejestracje botów już przy zapisie.
Automatyzacje z webhookami
Uruchamiaj walidację automatycznie po webhooku z formularza dzięki gotowym integracjom z Zapier i n8n.
Zmiany w profilu konta
Weryfikuj nowe adresy e-mail, gdy obecni użytkownicy zmieniają profil albo dane kontaktowe do rozliczeń.
Pola odpowiedzi, których użyjesz przy rejestracji
Krótki przegląd głównych pól JSON potrzebnych do reguł walidacji formularza.
| Pole JSON | Typ | Zastosowanie przy rejestracji |
|---|---|---|
| data.is_valid | boolean | Szybki test logiczny. True, gdy testy domeny i skrzynki przejdą pomyślnie. |
| data.status | string | Główny status dostarczenia: „deliverable”, „undeliverable”, „unknown”. |
| data.deliverability_score | number (0-100) | Wynik jakości oparty na odpowiedziach skrzynki, stabilności MX i testach reputacji. |
| data.details.attributes.disposable | boolean | True, gdy domena to znana usługa tymczasowych lub jednorazowych skrzynek. |
| data.details.attributes.free_email | boolean | True dla dostawców poczty dla konsumentów (Gmail, Outlook). W formularzach B2B wymagaj domen firmowych. |
| data.details.attributes.role_account | boolean | True dla adresów organizacyjnych, takich jak info@, admin@ lub support@. |
| data.catch_all_verdict | "valid" | "invalid" | null | Sprawdzanie domen catch-all w tym samym wywołaniu. Odzyskujesz prawidłowe kontakty, zamiast je odrzucać. |
Pełne definicje endpointów, schematy parametrów i kody błędów znajdziesz w pełnej dokumentacji API.
Cennik API do walidacji email
Płacisz tylko za wykonane walidacje, bez miesięcznych minimów i zobowiązań. Każde wywołanie API zużywa 1 kredyt, a test catch-all w tym samym wywołaniu jest w cenie. Kredyty za nieznane wyniki są zwracane automatycznie, a pierwsze 1000 kredytów dostajesz za darmo.
Wszystkie pakiety i rabat w abonamencie miesięcznym znajdziesz na stronie z cennikiem.
API do walidacji email: pytania i odpowiedzi
Odpowiedzi na częste pytania o wdrożenie w formularzach rejestracji i walidację w czasie rzeczywistym.
Tak. Każde nowe konto dostaje 1000 darmowych kredytów przy rejestracji, bez karty płatniczej. Klucz API wygenerujesz w panelu dewelopera i od razu możesz testować walidację formularzy w czasie rzeczywistym. Darmowe kredyty nigdy nie wygasają i dają pełny dostęp do wszystkich atrybutów i testów walidacji.
Nie. Wywołanie API bezpośrednio z JavaScriptu po stronie klienta ujawniłoby twój tajny klucz API każdemu, kto podejrzy zapytania sieciowe w przeglądarce. Zawsze wysyłaj dane z formularza najpierw do własnego serwera backendu lub funkcji serverless. Zapytanie do https://api.giggal.ai/v1/verify powinien wykonać twój serwer.
Nie jest wysyłana żadna wiadomość. API sprawdza, czy skrzynka istnieje. Zamyka połączenie, zanim zostaną przesłane jakiekolwiek dane lub treść e-maila, więc do skrzynek twoich użytkowników nic nie trafia.
Tak. Każdy test porównuje domenę z naszym rejestrem ponad 100 000 jednorazowych i tymczasowych domen e-mail. Jeśli domena jest w rejestrze, details.attributes.disposable zwraca true, a status ma wartość undeliverable. Twój backend może wtedy zablokować tymczasowe konto.
To zależy od twojego modelu biznesowego. W aplikacjach dla konsumentów adresy funkcyjne, takie jak support@ czy info@, mogą należeć do prawdziwych organizacji. W samoobsługowym SaaS B2B, gdzie liczy się odpowiedzialność konkretnego użytkownika, wiele firm oznacza albo blokuje ogólne adresy funkcyjne, aby zapobiec nadużyciom wspólnych danych logowania.
Domeny catch-all przyjmują każdy adres odbiorcy bez warunków, więc zwykłe testy nie dają jasnego wyniku. Nasze API w tym samym wywołaniu wykonuje dokładną weryfikację catch-all i sprawdza, czy skrzynka istnieje. Jeśli test catch-all zwróci „valid”, możesz bezpiecznie przepuścić rejestrację. Jeśli zwróci „invalid”, adres da odbicie i trzeba go zatrzymać.
Zalecamy wzorzec fail-open. Jeśli wywołanie z backendu przekroczy limit czasu albo wystąpi błąd połączenia, pozwól dokończyć rejestrację, zamiast blokować potencjalnego klienta. Dodaj niesprawdzony adres do kolejki zadań w tle i sprawdź jego status później.
Wybierz API do walidacji email, gdy potrzebujesz testów w czasie rzeczywistym w formularzach rejestracji, aby zatrzymać literówki, jednorazowe skrzynki i boty przy wysłaniu formularza. Wybierz API do weryfikacji email, gdy sprawdzasz istniejące bazy marketingowe, synchronizujesz kontakty w CRM albo masowo czyścisz pliki z adresami przed kampanią.
Chroń swoje formularze rejestracji już dziś
1000 darmowych kredytów, bez karty płatniczej.
