API de validation d’email en temps réel pour les formulaires d’inscription
Validez les adresses au moment où les utilisateurs les envoient. Un seul appel contrôle le serveur de messagerie et l’existence de la boîte mail. Il signale aussi les adresses jetables et génériques, pour que vous décidiez quoi accepter. Notre API de validation d’email bloque les mauvaises données dès l’entrée et garde les faux comptes hors de votre base.
// 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 crédits gratuits, aucune carte requise. Les crédits n’expirent jamais.
Pourquoi une regex seule ne suffit pas à valider un email
Une expression régulière ne contrôle que la structure du texte : la présence d’un @, un format de domaine plausible et des caractères dans les plages ASCII standard. Une regex indique seulement si une saisie ressemble à une adresse mail. Elle ne dit pas si quelqu’un peut y recevoir des messages.
Les saisies user@example.com ou asdf12345@gmail.com passent sans problème toutes les regex conformes aux RFC. Pourtant, l’un des domaines peut n’avoir aucun serveur de messagerie actif, et l’autre boîte mail peut ne pas exister.
Notre API de validation d’email au format JSON va bien plus loin que les expressions régulières. En une seule requête, elle inspecte les enregistrements DNS, recherche les serveurs MX, se connecte au serveur de messagerie de destination pour tester la boîte mail et compare le domaine à de longues listes de domaines jetables.
Les regex trop strictes provoquent aussi de faux refus. Les expressions maison rejettent souvent des domaines de premier niveau peu courants comme .studio ou .cloud, des caractères internationaux valides ou des adresses légitimes avec une ponctuation inhabituelle. Notre API applique automatiquement toutes les règles de syntaxe de la RFC 5322. Vous n’avez plus à maintenir des bibliothèques de regex fragiles dans votre code.
Contrôle de syntaxe
Repère les fautes de frappe simples, les extensions de domaine manquantes, la ponctuation interdite et les espaces, avant toute requête réseau.
Vérification DNS et MX
Vérifie que le domaine est enregistré et trouve les serveurs de messagerie configurés pour accepter le courrier entrant.
Contrôle de la boîte mail
Échange directement avec le serveur de messagerie distant pour confirmer que la boîte mail précise existe et peut recevoir du courrier.
Que bloquer, signaler ou accepter à l’inscription
Chaque entreprise a ses propres règles d’inscription. Un SaaS B2B peut exiger des emails professionnels, alors qu’une application grand public accepte volontiers les adresses Gmail personnelles. Voici la grille de décision recommandée, basée sur les vrais attributs de la réponse de l’API :
| Résultat de l’API | Condition sur le champ | Ce que le formulaire doit faire |
|---|---|---|
| Invalide | status === "undeliverable" | Bloquer tout de suite. Message : « Veuillez saisir une adresse mail valide et active. » |
| Jetable | details.attributes.disposable === true | Bloquer, ou demander une autre adresse. Message : « Les adresses mail temporaires ne sont pas acceptées. » |
| Adresse générique | details.attributes.role_account === true | Accepter, mais signaler sur les formulaires B2B. Prévenir les responsables de compte ou classer dans les leads généraux. |
| Messagerie gratuite | details.attributes.free_email === true | Accepter sur les applications B2C. Exiger un email professionnel sur les formulaires B2B de démo ou d’essai. |
| Catch-all | details.attributes.catch_all === true | Lire catch_all_verdict : si « valid », accepter ; si « invalid », bloquer ; si null, autoriser l’inscription. |
| Inconnu | status === "unknown" | Accepter et vérifier de nouveau plus tard (remboursé). En cas de doute, laisser passer, pour ne jamais bloquer un vrai utilisateur. |
Ajouter la validation d’email à votre formulaire d’inscription
Suivez ces quatre étapes pour intégrer la validation en temps réel en toute sécurité. Les requêtes exigent votre clé API privée. Lancez donc le contrôle depuis votre serveur backend.
Pourquoi laisser passer en cas d’échec : les formulaires d’inscription sont sensibles aux délais. Si un appel à une API externe est ralenti par le réseau, bloquer le formulaire peut vous faire perdre un vrai client. Avec un délai d’attente court et une inscription autorisée par défaut, les vrais utilisateurs ne sont pas refusés. Votre backend place l’adresse en file d’attente pour un contrôle en arrière-plan plus tard.
Le formulaire envoie les données à votre backend
Quand un visiteur envoie ses informations d’inscription, le navigateur transmet l’adresse mail à un endpoint de votre application.
Le backend appelle l’API de validation
Votre serveur envoie une requête POST synchrone à Giggal avec votre clé privée, stockée dans une variable d’environnement.
Le backend applique la grille de décision
Lisez les attributs JSON. Si l’email est jetable ou non délivrable, renvoyez un message d’erreur clair au navigateur.
Laisser passer si le délai est dépassé
Si l’appel réseau dépasse le délai, laissez passer : acceptez l’inscription et créez une tâche en arrière-plan pour vérifier l’adresse plus tard.
Exemples de code d’intégration
// 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();
}
});Important : n’appelez jamais l’endpoint de l’API Giggal directement depuis un script côté client. Gardez vos identifiants privés sur votre serveur.
Bloquer les inscriptions jetables et fausses
Les boîtes temporaires faussent les statistiques de votre produit, consomment vos quotas d’essai gratuit et ne deviennent jamais des clients payants. Notre service surveille et signale les schémas d’inscription à risque.
Boîtes jetables
Comparées à notre registre de plus de 100 000 domaines temporaires, tenu à jour. Découvrez comment nous repérons les boîtes jetables avec notre vérificateur d’adresse mail jetable.
Détection des alias avec signe plus
Signale les alias créés avec un signe plus (user+trial@domain.com), pour qu’un même utilisateur ne crée pas plusieurs comptes d’essai.
Détection des boîtes no-reply
Repère les boîtes d’envoi automatique qui ignorent les messages reçus. Les utilisateurs ne peuvent pas s’inscrire avec une adresse que personne ne consulte.
Ne corrigez pas automatiquement les fautes de frappe
Ne modifiez jamais une saisie sans prévenir l’utilisateur (par exemple remplacer gnail.com par gmail.com automatiquement). Si une adresse échoue à la validation, affichez un message clair pour que l’utilisateur vérifie sa saisie. Une correction silencieuse risque d’envoyer des liens d’activation de compte ou des reçus de paiement à la mauvaise personne.
Où valider les emails en temps réel
Validez les adresses mail partout où les utilisateurs envoient un formulaire dans votre produit.
Formulaires d’inscription
Empêchez les inscriptions de spam et assurez-vous que les emails de bienvenue et les liens de confirmation arrivent dans des boîtes actives.
Paiement en e-commerce
Assurez-vous que les avis d’expédition, les reçus et les confirmations de commande arrivent chez vos clients sans échec de livraison.
Demandes de contact et de démo
Écartez les fausses demandes de concurrents et vérifiez les domaines d’entreprise avant d’envoyer les prospects à vos commerciaux.
Inscriptions à la newsletter
Protégez la réputation de votre domaine d’envoi en refusant les saisies mal formées et les inscriptions de robots dès l’opt-in.
Automatisations par webhook
Lancez la validation automatiquement sur les webhooks de vos formulaires avec nos intégrations Zapier et n8n prêtes à l’emploi.
Modification du profil
Vérifiez les nouvelles adresses quand un utilisateur existant modifie son profil ou son contact de facturation.
Les champs de réponse utiles à l’inscription
Une référence courte des principaux champs JSON nécessaires pour appliquer vos règles de validation de formulaire.
| Champ JSON | Type | Usage à l’inscription |
|---|---|---|
| data.is_valid | boolean | Contrôle booléen rapide. Vrai quand les vérifications du domaine et de la boîte mail réussissent. |
| data.status | string | Statut de délivrabilité principal : "deliverable", "undeliverable", "unknown". |
| data.deliverability_score | number (0-100) | Score de qualité basé sur les réponses de la boîte mail, la stabilité des MX et les contrôles de réputation. |
| data.details.attributes.disposable | boolean | Vrai quand le domaine est un service connu de boîtes temporaires ou jetables. |
| data.details.attributes.free_email | boolean | Vrai pour les messageries grand public (Gmail, Outlook). Exigez un domaine d’entreprise sur les formulaires B2B. |
| data.details.attributes.role_account | boolean | Vrai pour les adresses génériques d’organisation comme info@, admin@ ou support@. |
| data.catch_all_verdict | "valid" | "invalid" | null | Résolution des domaines catch-all dans le même appel. Récupérez les contacts valides au lieu de les supprimer. |
Pour les définitions complètes des endpoints, les schémas des paramètres et les codes d’erreur, consultez la référence complète de l’API.
Tarifs de l’API de validation d’email
Payez seulement les validations que vous lancez, sans minimum mensuel ni engagement. Chaque appel de validation consomme 1 crédit, contrôles catch-all compris. Les résultats inconnus sont remboursés automatiquement, et vos 1 000 premiers crédits sont gratuits.
Découvrez tous les paliers de volume et les remises des abonnements mensuels sur notre page des tarifs.
FAQ sur l’API de validation d’email
Les réponses aux questions fréquentes sur l’intégration dans les formulaires d’inscription et la validation en temps réel.
Oui. Chaque nouveau compte reçoit 1 000 crédits gratuits à l’inscription, sans carte bancaire. Vous pouvez créer une clé API dans votre tableau de bord et tester tout de suite la validation de formulaires en temps réel. Les crédits gratuits n’expirent jamais et donnent accès à tous les attributs et contrôles de validation.
Non. Un appel direct depuis du JavaScript côté client exposerait votre clé API secrète à toute personne qui inspecte les requêtes réseau du navigateur. Envoyez toujours les saisies du formulaire à votre propre serveur backend ou à une fonction serverless. C’est votre serveur qui exécute ensuite la requête vers https://api.giggal.ai/v1/verify.
Aucun message n’est jamais envoyé. L’API vérifie si la boîte mail existe. Elle ferme la connexion avant la transmission de tout contenu d’email. Vos utilisateurs ne reçoivent donc rien dans leur boîte.
Oui. Chaque contrôle compare le domaine à notre registre de plus de 100 000 domaines d’emails jetables et temporaires. En cas de correspondance, details.attributes.disposable renvoie true et le statut passe à undeliverable. Votre backend peut alors bloquer les comptes temporaires.
Cela dépend de votre modèle. Pour les applications grand public, une adresse générique comme support@ ou info@ peut appartenir à une vraie organisation. Pour un SaaS B2B en libre-service qui a besoin de savoir qui utilise chaque compte, beaucoup d’entreprises signalent ou refusent les adresses génériques. Elles évitent ainsi le partage d’identifiants.
Les domaines catch-all acceptent toutes les adresses sans condition, donc les contrôles standard ne donnent pas de réponse claire. Notre API lance une vérification catch-all approfondie dans le même appel pour savoir si la boîte mail existe. Si le contrôle catch-all renvoie « valid », vous pouvez accepter l’inscription. S’il renvoie « invalid », l’adresse rebondira et doit être bloquée.
Nous recommandons de laisser passer en cas d’échec. Si l’appel de votre backend dépasse le délai ou subit une erreur de connexion, laissez l’inscription se terminer au lieu de bloquer un client potentiel. Placez l’adresse non validée dans une file de tâches en arrière-plan pour vérifier sa délivrabilité plus tard.
Choisissez une API de validation d’email pour des contrôles en temps réel dans vos formulaires web, afin de stopper les fautes de frappe, les boîtes jetables et les robots à l’envoi. Choisissez une API de vérification d’email pour contrôler une base marketing existante, synchroniser des contacts CRM ou nettoyer de gros fichiers d’emails avant une campagne.
Protégez vos formulaires d’inscription dès aujourd’hui
1 000 crédits offerts, sans carte bancaire.
