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.

Obsługa rejestracji w backendzieDecyzja formularza
// 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.

1

Test składni

Wyłapuje proste literówki, brak domeny najwyższego poziomu, niedozwoloną interpunkcję i spacje, zanim zostanie wykonane jakiekolwiek zapytanie sieciowe.

2

Weryfikacja DNS i MX

Sprawdza, czy domena jest zarejestrowana, i wyszukuje skonfigurowane serwery pocztowe, które mogą przyjmować wiadomości.

3

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 APIWarunek polaCo powinien zrobić formularz
Nieprawidłowystatus === "undeliverable"Zablokuj od razu. Pokaż komunikat: „Podaj prawidłowy, aktywny adres e-mail.”
Jednorazowydetails.attributes.disposable === trueZablokuj albo poproś o inny adres. Pokaż komunikat: „Tymczasowe adresy e-mail są niedozwolone.”
Adres funkcyjnydetails.attributes.role_account === truePrzepuść, ale oznacz w formularzach B2B. Powiadom opiekunów klientów albo przekaż adres do ogólnej puli leadów.
Darmowa pocztadetails.attributes.free_email === truePrzepuść w aplikacjach B2C. W formularzach demo i okresu próbnego B2B wymagaj firmowego adresu.
Catch-alldetails.attributes.catch_all === trueSprawdź catch_all_verdict: jeśli „valid”, przepuść; jeśli „invalid”, zablokuj; jeśli null, pozwól na rejestrację.
Nieznanystatus === "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.

1

Formularz wysyła dane do backendu

Gdy odwiedzający wysyła dane rejestracji, przeglądarka przesyła adres e-mail do endpointu twojej aplikacji.

2

Backend wywołuje API do walidacji

Twój serwer wysyła synchroniczne zapytanie POST do Giggal z prywatnym kluczem zapisanym w zmiennej środowiskowej.

3

Backend stosuje tabelę decyzji

Odczytaj atrybuty JSON. Jeśli adres jest jednorazowy albo niedostarczalny, zwróć do przeglądarki jasny komunikat o błędzie.

4

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

Backend: Node.js (trasa Express)tylko po stronie serwera
// 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 });
});
Backend: Python (trasa Flask)tylko po stronie serwera
# 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: klient w przeglądarce (wywołuje twój backend)skrypt po stronie klienta
// 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 JSONTypZastosowanie przy rejestracji
data.is_validbooleanSzybki test logiczny. True, gdy testy domeny i skrzynki przejdą pomyślnie.
data.statusstringGłówny status dostarczenia: „deliverable”, „undeliverable”, „unknown”.
data.deliverability_scorenumber (0-100)Wynik jakości oparty na odpowiedziach skrzynki, stabilności MX i testach reputacji.
data.details.attributes.disposablebooleanTrue, gdy domena to znana usługa tymczasowych lub jednorazowych skrzynek.
data.details.attributes.free_emailbooleanTrue dla dostawców poczty dla konsumentów (Gmail, Outlook). W formularzach B2B wymagaj domen firmowych.
data.details.attributes.role_accountbooleanTrue dla adresów organizacyjnych, takich jak info@, admin@ lub support@.
data.catch_all_verdict"valid" | "invalid" | nullSprawdzanie 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.

Kredyty
3000kredytów
Cena0,0017 USD / kredyt
Oszczędność
-
Razem
5,00 USDjednorazowo
Kredyty
10 000kredytów
Cena0,0010 USD / kredyt
Oszczędność
Oszczędzasz 41%
Razem
9,90 USDjednorazowo
Kredyty
30 000kredytów
Cena0,0009 USD / kredyt
Oszczędność
Oszczędzasz 44%
Razem
28,00 USDjednorazowo
Kredyty
50 000kredytów
Cena0,0008 USD / kredyt
Oszczędność
Oszczędzasz 53%
Razem
39,00 USDjednorazowo
Kredyty
100 000kredytówNajczęściej wybierany
Cena0,0008 USD / kredyt
Oszczędność
Oszczędzasz 54%
Razem
76,00 USDjednorazowo
Kredyty
300 000kredytów
Cena0,0007 USD / kredyt
Oszczędność
Oszczędzasz 56%
Razem
222,00 USDjednorazowo
Kredyty
500 000kredytów
Cena0,0007 USD / kredyt
Oszczędność
Oszczędzasz 57%
Razem
360,00 USDjednorazowo
Kredyty
800 000kredytów
Cena0,0007 USD / kredyt
Oszczędność
Oszczędzasz 58%
Razem
559,00 USDjednorazowo
Kredyty
1 000 000kredytów
Cena0,0007 USD / kredyt
Oszczędność
Oszczędzasz 59%
Razem
680,00 USDjednorazowo

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.

Darmowy test Kredyty nie wygasają Zwrot kredytów za wyniki nieznane