E-mailvalidatie-API in realtime voor aanmeldformulieren
Valideer adressen op het moment dat gebruikers ze versturen. Eén call controleert de mailserver en of de mailbox bestaat. Kenmerken voor wegwerpadressen en rol-adressen laten jou beslissen wat je accepteert. Onze e-mailvalidatie-API houdt slechte adressen tegen voordat ze in je database komen. Zo krijg je geen nepaccounts.
// 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 });1.000 gratis credits, geen creditcard nodig. Credits verlopen nooit.
Waarom regex alleen geen e-mailvalidatie is
Een reguliere expressie controleert alleen de opbouw van de tekst: of er een @ in staat, of het domein er plausibel uitziet en of de tekens binnen het gewone ASCII-bereik vallen. Regex vertelt je alleen of een invoer eruitziet als een e-mailadres. Het vertelt je niet of iemand daar berichten kan ontvangen.
Typ je user@example.com of asdf12345@gmail.com, dan komt dat door elke regex die de RFC volgt. Toch kan het ene domein geen actieve mailservers hebben, en kan de andere mailbox niet bestaan.
Onze e-mailvalidatie-API met JSON-antwoord gaat veel verder dan reguliere expressies. In één verzoek bekijkt hij de DNS-records, zoekt hij de MX-hosts op, maakt hij verbinding met de ontvangende mailserver om de mailbox te testen en vergelijkt hij het domein met grote lijsten van wegwerpdomeinen.
Strakke regex-patronen wijzen ook goede adressen af. Eigen expressies weigeren vaak minder gewone topleveldomeinen zoals .studio of .cloud, geldige internationale tekens of echte adressen met ongewone leestekens. Onze API verwerkt alle syntaxisregels van RFC 5322 automatisch. Je hoeft dus geen kwetsbare regex-bibliotheken in je code te onderhouden.
Syntaxiscontrole
Vindt eenvoudige tikfouten, ontbrekende topleveldomeinen, ongeldige leestekens en spaties, nog voor er iets op het netwerk wordt opgezocht.
DNS- en MX-controle
Controleert of het domein geregistreerd is en zoekt de ingestelde mailservers die inkomende berichten kunnen ontvangen.
Controle van de mailbox
Praat direct met de externe mailserver om te bevestigen of die mailbox bestaat en mail kan ontvangen.
Wat je bij aanmelding blokkeert, markeert of toestaat
Elk bedrijf stelt andere eisen aan een aanmelding. Een B2B-SaaS voor grote bedrijven kan een zakelijk e-mailadres verplicht stellen, terwijl een sociale app voor consumenten persoonlijke Gmail-adressen welkom heet. Dit is de aanbevolen beslistabel, gebaseerd op echte kenmerken in het API-antwoord:
| API-resultaat | Veldvoorwaarde | Wat het formulier doet |
|---|---|---|
| Ongeldig | status === "undeliverable" | Direct blokkeren. Toon: "Vul een geldig en actief e-mailadres in." |
| Wegwerpadres | details.attributes.disposable === true | Blokkeren of om een ander adres vragen. Toon: "Tijdelijke e-mailadressen zijn niet toegestaan." |
| Rol-adres | details.attributes.role_account === true | Toestaan, en markeren op B2B-formulieren. Laat accountmanagers het weten of zet het adres bij de algemene leads. |
| Gratis e-mail | details.attributes.free_email === true | Toestaan in B2C-apps. Op B2B-formulieren voor een demo of proefperiode een zakelijk e-mailadres verplichten. |
| Catch-all | details.attributes.catch_all === true | Controleer catch_all_verdict: bij "valid" toestaan, bij "invalid" blokkeren, bij null de registratie toestaan. |
| Onbekend | status === "unknown" | Accepteren en later opnieuw controleren (terugbetaald). Laat het formulier doorgaan, zodat echte gebruikers nooit worden geblokkeerd. |
E-mailvalidatie toevoegen aan je aanmeldformulier
Volg deze vier stappen om validatie in realtime veilig in te bouwen. De verzoeken hebben je geheime API-sleutel nodig. Voer de controle daarom uit vanaf je backendserver.
Waarom fail-open belangrijk is: aanmeldformulieren zijn gevoelig voor vertraging. Als een externe API-call traag is door het netwerk, kun je een echte klant verliezen door het formulier te blokkeren. Stel een korte time-out in en laat de registratie daarna automatisch doorgaan. Zo stuur je echte gebruikers niet weg, en zet je backend het adres in een wachtrij voor een controle op de achtergrond.
Het formulier stuurt naar je backend
Als een bezoeker zijn registratiegegevens verstuurt, stuurt de browser het e-mailadres naar een endpoint van je applicatie.
De backend roept de validatie-API aan
Je server stuurt een synchroon POST-verzoek naar Giggal met je geheime sleutel, die in een omgevingsvariabele staat.
De backend past de beslistabel toe
Lees de kenmerken in de JSON. Is het e-mailadres een wegwerpadres of niet bezorgbaar, stuur dan een duidelijke foutmelding terug naar de browser.
Doorgaan bij een time-out
Duurt de verbinding met de API te lang, laat de registratie dan doorgaan (fail-open) en zet een taak in de wachtrij om het adres later te controleren.
Codevoorbeelden voor de implementatie
// 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();
}
});Belangrijk: roep het endpoint van de Giggal API nooit direct aan vanuit scripts in de browser. Houd je gegevens geheim op je server.
Stop aanmeldingen met wegwerpadressen en nepadressen
Tijdelijke mailboxen maken je productcijfers onbetrouwbaar, gebruiken gratis proefperiodes op en worden nooit betalende klanten. Onze dienst herkent en markeert riskante patronen bij aanmeldingen.
Wegwerpmailboxen
Gecontroleerd tegen onze actuele lijst van meer dan 100.000 tijdelijke domeinen. Lees hoe we wegwerpmailboxen herkennen op de pagina van onze wegwerp-e-mailchecker.
Plus-adressering herkennen
Markeert aliassen die met een plus-tag zijn gemaakt (user+trial@domain.com). Zo maakt één gebruiker geen dubbele proefaccounts.
No-reply-mailboxen herkennen
Herkent automatische mailboxen en verzendadressen die inkomende berichten weggooien. Zo melden gebruikers zich niet aan met een adres dat niemand leest.
Verbeter tikfouten van gebruikers niet automatisch
Pas wat een gebruiker invult nooit stilletjes aan (bijvoorbeeld gnail.com automatisch veranderen in gmail.com). Komt een adres niet door de validatie, vraag de gebruiker dan met een duidelijke melding om zijn invoer te controleren. Als je adressen stilletjes aanpast, kunnen activatielinks of facturen bij de verkeerde persoon terechtkomen.
Waar je e-mailadressen in realtime valideert
Valideer e-mailadressen overal waar gebruikers in je product een formulier versturen.
Registratieformulieren
Voorkom spam bij registratie en zorg dat welkomstmails en verificatielinks in actieve mailboxen aankomen.
Afrekenen in een webshop
Zorg dat verzendberichten, bonnen en orderbevestigingen klanten bereiken zonder bezorgfouten.
Aanvragen voor leads en demo’s
Filter nepinzendingen van concurrenten en controleer bedrijfsdomeinen voordat je prospects doorstuurt naar je verkopers.
Aanmeldingen voor de nieuwsbrief
Bescherm de reputatie van je verzenddomein door onjuiste invoer en aanmeldingen van bots te weigeren bij de opt-in.
Automatisering met webhooks
Start de validatie automatisch via webhooks van formulieren met onze kant-en-klare integraties voor Zapier en n8n.
Wijzigingen in het profiel
Controleer het nieuwe e-mailadres als bestaande gebruikers hun profiel of hun factuurcontact wijzigen.
Velden in het antwoord die je bij aanmelding gebruikt
Een kort overzicht van de belangrijkste JSON-velden voor de validatieregels in je formulier.
| JSON-veld | Type | Gebruik bij aanmelding |
|---|---|---|
| data.is_valid | boolean | Snelle booleaanse controle. True als de controles van domein en mailbox slagen. |
| data.status | string | Belangrijkste status: "deliverable", "undeliverable", "unknown". |
| data.deliverability_score | number (0-100) | Kwaliteitsscore op basis van de antwoorden van de mailbox, de stabiliteit van de MX en reputatiecontroles. |
| data.details.attributes.disposable | boolean | True als het domein een bekende dienst voor tijdelijke of wegwerpmailboxen is. |
| data.details.attributes.free_email | boolean | True voor providers voor consumenten (Gmail, Outlook). Vraag om een zakelijk domein op B2B-formulieren. |
| data.details.attributes.role_account | boolean | True voor adressen van een organisatie, zoals info@, admin@ of support@. |
| data.catch_all_verdict | "valid" | "invalid" | null | Beoordeling van catch-all-domeinen in dezelfde call. Zo haal je geldige leads terug zonder ze weg te gooien. |
Alle endpoints, parameterschema’s en foutcodes staan in de volledige API-documentatie.
Prijzen van de e-mailvalidatie-API
Je betaalt alleen voor de validaties die je uitvoert, zonder maandelijks minimum of verplichting. Elke validatie via de API kost 1 credit, inclusief de catch-all-controle. Onbekende resultaten worden automatisch terugbetaald, en je eerste 1.000 credits zijn gratis.
Bekijk alle volumes en de korting op maandabonnementen op onze prijspagina.
Veelgestelde vragen over de e-mailvalidatie-API
Antwoorden op veelgestelde vragen over het inbouwen in registratieformulieren en validatie in realtime.
Ja. Elk nieuw account krijgt bij registratie 1.000 gratis credits, zonder creditcard. Je maakt een API-sleutel aan in je dashboard en kunt meteen validaties in formulieren testen. De gratis credits verlopen nooit en geven toegang tot alle kenmerken en controles.
Nee. Als je de API direct aanroept vanuit JavaScript in de browser, kan iedereen die de netwerkverzoeken bekijkt je geheime API-sleutel zien. Stuur de invoer van het formulier altijd eerst naar je eigen backendserver of serverless functie. Laat je server daarna het verzoek naar https://api.giggal.ai/v1/verify uitvoeren.
Er wordt nooit een bericht verstuurd. De API controleert of de mailbox bestaat. Hij sluit de verbinding voordat er e-mailgegevens of inhoud worden verstuurd. Je gebruikers krijgen dus niets in hun inbox.
Ja. Elke controle vergelijkt het domein met onze lijst van meer dan 100.000 wegwerpdomeinen en tijdelijke e-maildomeinen. Is er een match, dan geeft details.attributes.disposable true terug en wordt de status undeliverable. Zo kan je backend tijdelijke accounts blokkeren.
Dat hangt af van je bedrijfsmodel. In apps voor consumenten kunnen rol-adressen zoals support@ of info@ bij echte organisaties horen. Bij self-service B2B-SaaS, waar je wilt weten wie een account gebruikt, kiezen veel bedrijven ervoor om algemene rol-adressen te markeren of te weigeren. Zo voorkomen ze dat inloggegevens worden gedeeld.
Catch-all-domeinen accepteren elk adres zonder voorwaarde. Daardoor geeft een standaardcontrole geen duidelijk antwoord. Onze API voert de catch-all-controle in dezelfde call uit en kijkt of de mailbox bestaat. Geeft de catch-all-controle "valid", dan kun je de aanmelding veilig toestaan. Bij "invalid" zal het adres bouncen en moet je het tegenhouden.
We raden fail-open aan. Krijgt je backend een time-out of een verbindingsfout, laat de registratie dan doorgaan in plaats van een mogelijke klant te blokkeren. Zet het niet gevalideerde adres in de wachtrij van je achtergrondproces, zodat je de status later opnieuw controleert.
Kies een e-mailvalidatie-API als je in realtime wilt controleren in registratieformulieren op je website, om tikfouten, wegwerpmailboxen en bots te stoppen bij het verzenden. Kies een e-mailverificatie-API als je bestaande marketingdatabases controleert, CRM-contacten synchroniseert of bulkbestanden met e-mailadressen opschoont voordat je campagnes verstuurt.
Bescherm je aanmeldformulieren vandaag nog
1.000 gratis credits, zonder creditcard.
