API de validación de correo en tiempo real para formularios de registro
Valida las direcciones cuando los usuarios las envían: el servidor de correo y si el buzón existe en una sola llamada, con indicadores de desechable y de rol para que decidas qué aceptar. Nuestra API de validación de correo bloquea los datos malos antes de que entren y mantiene las cuentas falsas fuera de tu base de datos.
// 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éditos gratis, sin tarjeta. Los créditos no caducan.
Por qué una regex por sí sola no es validación de correo
Una expresión regular solo comprueba la estructura del texto: si hay una @, si el formato del dominio parece plausible y si los caracteres están dentro de los rangos ASCII estándar. Una regex solo responde si una entrada parece una dirección de correo, no si alguien puede recibir mensajes en ella.
Escribir user@example.com o asdf12345@gmail.com pasa sin problema cualquier regex que cumpla el RFC. Sin embargo, uno de los dominios puede no tener servidores de correo activos, y el otro buzón puede no existir.
Nuestra API de validación de correo con respuesta JSON va mucho más allá de las expresiones regulares. En una sola solicitud revisa los registros DNS, consulta los servidores MX, se conecta al servidor de correo de destino para probar si el buzón responde y compara el dominio con amplias listas de dominios desechables.
Los patrones regex rígidos también causan rechazos falsos. Las expresiones personalizadas suelen rechazar dominios de nivel superior poco comunes como .studio o .cloud, caracteres internacionales válidos o direcciones legítimas con puntuación poco habitual. Nuestra API maneja automáticamente toda la sintaxis de RFC 5322, así que no tienes que mantener frágiles bibliotecas de regex en tu código.
Comprobación de sintaxis
Detecta errores de escritura básicos, TLD que faltan, puntuación no permitida y espacios antes de cualquier consulta de red externa.
Verificación DNS y MX
Comprueba que el dominio está registrado y encuentra los servidores de correo configurados que pueden aceptar mensajes entrantes.
Comprobación del buzón
Se comunica directamente con el servidor de correo remoto para confirmar si ese buzón existe y puede recibir correo.
Qué bloquear, marcar o permitir en el registro
Cada negocio tiene requisitos de registro distintos. Un SaaS B2B para empresas puede exigir correos corporativos, mientras que una app social de consumo acepta direcciones personales de Gmail. Esta es la tabla de decisiones recomendada según los atributos reales de la respuesta de la API:
| Resultado de la API | Condición del campo | Qué debe hacer el formulario |
|---|---|---|
| No válido | status === "undeliverable" | Bloquear de inmediato. Mostrar: "Escribe una dirección de correo válida y activa." |
| Desechable | details.attributes.disposable === true | Bloquear o pedir otra dirección. Mostrar: "No se permiten direcciones de correo temporales." |
| Cuenta de rol | details.attributes.role_account === true | Permitir; marcar en formularios B2B. Avisar a los gestores de cuenta o enviar al grupo general de leads. |
| Correo gratuito | details.attributes.free_email === true | Permitir en apps B2C; exigir un correo corporativo en formularios de demo o de prueba B2B. |
| Catch-all | details.attributes.catch_all === true | Revisar catch_all_verdict: si es "valid", permitir; si es "invalid", bloquear; si es null, permitir el registro. |
| Desconocido | status === "unknown" | Aceptar y volver a comprobar más tarde (se reembolsa). Si falla, dejar pasar (fail-open), así nunca se bloquea a usuarios legítimos. |
Añade validación de correo a tu formulario de registro
Sigue esta secuencia de cuatro pasos para integrar la validación en tiempo real de forma segura. Como las solicitudes necesitan tu clave de API privada, haz la comprobación desde tu servidor backend.
Por qué importa el patrón fail-open: los formularios de registro son sensibles a los retrasos. Si una llamada a una API externa sufre latencia de red, bloquear el formulario puede hacerte perder a un cliente real. Si usas un tiempo de espera corto y dejas que el registro siga automáticamente, no rechazas a usuarios legítimos, y tu backend pone la dirección en cola para comprobarla más tarde en segundo plano.
El formulario envía los datos a tu backend
Cuando un visitante envía sus datos de registro, el navegador transmite la dirección de correo al endpoint de tu aplicación.
El backend llama a la API de validación
Tu servidor envía una solicitud POST síncrona a Giggal con tu clave privada guardada en una variable de entorno.
El backend aplica la tabla de decisiones
Lee los atributos del JSON. Si el correo es desechable o no entregable, devuelve al navegador un mensaje de error claro.
Dejar pasar si se agota el tiempo
Si la comunicación con la API agota el tiempo de espera, aplica fail-open: acepta el registro y pon en cola una tarea en segundo plano para verificarlo más tarde.
Ejemplos de código de implementación
// 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();
}
});Importante: nunca llames al endpoint de la API de Giggal directamente desde scripts del cliente. Mantén tus credenciales privadas en tu servidor.
Frena los registros desechables y falsos
Los buzones temporales distorsionan la analítica de tu producto, gastan las cuotas de prueba gratuita y nunca se convierten en clientes de pago. Nuestro servicio detecta y marca los patrones de registro de alto riesgo.
Buzones desechables
Se comparan con nuestro registro activo de más de 100.000 dominios temporales. Mira cómo identificamos los buzones de usar y tirar con nuestro verificador de correos desechables.
Detección de alias con signo más
Marca los alias creados con el signo más (user+trial@domain.com), para que una misma persona no cree varias cuentas de prueba.
Detección de buzones no-reply
Detecta los buzones automáticos y de difusión que descartan los mensajes entrantes, para que nadie se registre con direcciones que no responden.
No corrijas automáticamente los errores de escritura
Nunca cambies en silencio lo que escribe el usuario (por ejemplo, cambiar gnail.com por gmail.com de forma automática). Si una dirección no pasa la validación, muestra un mensaje claro para que el usuario revise lo que escribió. Si reescribes en silencio, puedes enviar enlaces de activación de cuenta o recibos de pago a otra persona.
Dónde validar correos en tiempo real
Valida las direcciones de correo en cualquier formulario de tu producto donde los usuarios envían datos.
Formularios de registro de usuarios
Evita el spam de registros y ayuda a que los correos de bienvenida y los enlaces de verificación lleguen a buzones activos.
Pago en tiendas online
Asegura que los avisos de envío, los recibos y las confirmaciones de pedido lleguen a los clientes sin fallos de entrega.
Solicitudes de contacto y de demo
Filtra las entradas falsas de la competencia y verifica los dominios de empresa antes de pasar los contactos a los comerciales.
Suscripciones a newsletters
Protege la reputación de tu dominio de envío: rechaza las entradas mal formadas y los registros de bots en el alta.
Automatizaciones con webhooks
Lanza la validación automáticamente desde los webhooks de tus formularios con nuestras integraciones de Zapier y n8n.
Cambios en el perfil de la cuenta
Verifica las nuevas direcciones cuando los usuarios cambian su perfil o su contacto de facturación.
Campos de la respuesta que usarás en el registro
Una referencia breve de los campos JSON principales que necesitas para aplicar la lógica de validación del formulario.
| Campo JSON | Tipo | Uso en el registro |
|---|---|---|
| data.is_valid | boolean | Comprobación booleana rápida. Es true cuando pasan las comprobaciones del dominio y del buzón. |
| data.status | string | Estado de entrega principal: "deliverable", "undeliverable", "unknown". |
| data.deliverability_score | number (0-100) | Puntuación de calidad basada en las respuestas del buzón, la estabilidad de los MX y las comprobaciones de reputación. |
| data.details.attributes.disposable | boolean | Es true cuando el dominio es un servicio conocido de buzones temporales o desechables. |
| data.details.attributes.free_email | boolean | Es true en proveedores de consumo (Gmail, Outlook). Exige dominios corporativos en formularios B2B. |
| data.details.attributes.role_account | boolean | Es true en direcciones de organización como info@, admin@ o support@. |
| data.catch_all_verdict | "valid" | "invalid" | null | Resolución de los dominios catch-all en la misma llamada. Recupera contactos válidos sin descartarlos. |
Para ver todas las definiciones de endpoints, los esquemas de parámetros y los códigos de error, consulta la referencia completa de la API.
Precios de la API de validación de correo
Paga solo por las validaciones que haces, sin mínimos mensuales ni compromisos. Cada llamada de validación a la API consume 1 crédito, con las comprobaciones catch-all incluidas en la misma llamada. Los resultados desconocidos se reembolsan automáticamente y tus primeros 1.000 créditos son totalmente gratis.
Mira todos los planes por volumen y los descuentos de la suscripción mensual en nuestra página de precios.
Preguntas frecuentes sobre la API de validación de correo
Respuestas a preguntas habituales de implementación sobre formularios de registro y validación en tiempo real.
Sí. Cada cuenta nueva recibe 1.000 créditos gratis al registrarse, sin tarjeta de crédito. Puedes generar una clave de API en tu panel de desarrollador y empezar a probar la validación de formularios en tiempo real de inmediato. Los créditos gratis no caducan y dan acceso completo a todos los atributos y comprobaciones de validación.
No. Llamar a la API desde JavaScript del cliente expondría tu clave de API secreta a cualquiera que revise las solicitudes de red del navegador. Envía siempre los datos del formulario primero a tu propio servidor backend o a una función serverless, y haz que tu servidor envíe la solicitud a https://api.giggal.ai/v1/verify.
Nunca se envía ningún mensaje. La API comprueba si el buzón existe. Cierra la conexión antes de transmitir ningún dato ni contenido del correo, así que tus usuarios no reciben nada en su bandeja de entrada.
Sí. Cada comprobación compara el dominio con nuestro registro de más de 100.000 dominios de correo desechables y temporales. Si hay coincidencia, details.attributes.disposable devuelve true y el estado pasa a undeliverable, para que tu backend pueda bloquear las cuentas temporales.
Depende de tu modelo de negocio. En las apps de consumo, cuentas de rol como support@ o info@ pueden ser de organizaciones legítimas. En un SaaS B2B de autoservicio donde importa saber quién es cada usuario, muchas empresas marcan o no permiten las cuentas de rol genéricas para evitar el uso compartido de credenciales.
Los dominios catch-all aceptan cualquier dirección de destinatario sin condiciones, así que las comprobaciones normales no son concluyentes. Nuestra API hace una verificación catch-all a fondo en la misma llamada para saber si el buzón existe. Si la comprobación catch-all devuelve "valid", puedes permitir el registro con seguridad; si devuelve "invalid", la dirección rebotará y debes detener el registro.
Recomendamos aplicar un patrón fail-open. Si la llamada de tu backend agota el tiempo de espera o da un error de conexión, deja que el registro se complete en lugar de bloquear a un posible cliente. Pon la dirección sin validar en la cola de tu proceso en segundo plano para volver a comprobar su estado de entrega más tarde.
Elige una API de validación de correo cuando necesites comprobaciones en tiempo real en formularios web de registro para frenar errores de escritura, buzones desechables y bots al enviar el formulario. Elige una API de verificación de correo cuando revises bases de datos de marketing existentes, sincronices contactos del CRM o limpies archivos masivos de correo antes de enviar campañas.
Protege hoy tus formularios de registro
1.000 créditos gratis, sin tarjeta.
