La validación de correos electrónicos es un paso crítico para garantizar que los datos de contacto que entran en tu sistema son correctos y utilizables. Con la API de VerificarEmails puedes integrar la verificación de emails de tres formas principales: validaciones individuales en tiempo real, validaciones masivas de listas mediante ficheros y validación directa en formularios gracias al widget WidgetJS.
A continuación, se explican estas modalidades con ejemplos prácticos. Los puntos que trataremos son:
-
Explicar la validación individual de emails con ejemplos cURL.
-
Incluir el flujo de validación masiva por ficheros con
/multiple. -
Mostrar cómo usar WidgetJS en formularios web con snippet de código.
-
Referenciar el uso de Postman para generar snippets en varios lenguajes.
-
Reforzar la idea de entregabilidad y calidad de datos.
Verificación individual con la API
Cuando necesitas validar un único correo (por ejemplo, en un formulario de registro o en un proceso puntual), puedes utilizar el endpoint /email/validate/single.
Ejemplo con cURL
curl -i "https://dashboard.verificaremails.com/myapi/email/validate/single?auth-token=TU_TOKEN&term=test@example.com" \
-H "accept: application/json"
Respuesta típica
{
"email": "test@example.com",
"is_valid": true,
"status": "ok",
"domain": "example.com",
"is_disposable": false,
"is_catch_all": false
}
Este endpoint devuelve información clave como:
- is_valid: si el correo es válido y puede recibir mensajes.
- is_disposable: si es un correo temporal o de un solo uso.
- is_catch_all: si el dominio acepta cualquier dirección aunque no exista el buzón.
👉 En la colección de Postman tienes ejemplos listos para importar y generar automáticamente snippets en Python, Node.js, PHP, etc.
Verificación masiva con ficheros
Cuando se trata de validar listas completas, la API ofrece el endpoint /email/validate/multiple. Este endpoint permite subir un fichero con miles de correos para validarlos en lote y obtener los resultados en un archivo procesado.
Ejemplo de subida de fichero con cURL
curl -X POST "https://dashboard.verificaremails.com/myapi/email/validate/multiple" \
-H "accept: application/json" \
-H "auth-token: TU_TOKEN" \
-F "file=@/ruta/a/tu/archivo_emails.csv"
Respuesta típica
{
"batch_id": "64cfa122c27b",
"status": "processing",
"total": 10000,
"processed": 0
}
Con el batch_id puedes consultar el estado del procesamiento y, una vez completado, descargar el fichero con todos los correos clasificados como válidos, inválidos, temporales, etc.
👉 Al igual que en la validación individual, en Postman encontrarás ejemplos que generan código en múltiples lenguajes, lo que facilita la integración en tus proyectos.
Validación en formularios con WidgetJS
Para los casos donde necesitas verificar emails directamente en tu web, VerificarEmails ofrece un widget JavaScript que puedes insertar en formularios sin necesidad de programar desde cero.
Cómo funciona
- Desde el dashboard, creas un nuevo widget en la sección WidgetJS.
- Seleccionas los servicios que quieres validar (por ejemplo, solo correos electrónicos).
- Configuras las reglas de aceptación (ej. aceptar solo resultados “OK”).
- Obtienes un snippet de código que insertas en tu formulario web.
Ejemplo de uso
<script src="https://cdn.verificaremails.com/widget.js"></script>
<script>
VerificarEmailsWidget.init({
token: "TU_TOKEN_WIDGET",
fields: ["#email"],
rules: { accept: ["ok"] }
});
</script>
El widget intercepta el campo de email, consulta en segundo plano la API y muestra al usuario si la dirección es válida antes de que pueda enviar el formulario.
Conclusión
La API de VerificarEmails.com te permite cubrir todas las necesidades de validación:
- Individual, para registros en tiempo real.
- Masiva, para limpiar grandes listas con el endpoint
/multiple. - WidgetJS, para integrar verificación en tus formularios web sin código adicional.
Con soporte en Postman, es sencillo extender estos ejemplos a cualquier lenguaje de programación. Esto asegura que tus sistemas trabajen siempre con datos limpios y que tus campañas de email marketing mantengan la mejor entregabilidad posible. Verificaremails según la opinión de los clientes de NewsletterSoft, plataforma con más de 15 años de experiencia en email marketing, es el mejor servicio de validación de correos electrónicos mediante API que han probado. La encuesta se realizó sobre un base de más de 300 clientes de la plataforma.
