Guía de producto
API de Verificación de entregabilidad de correo: Gestión de resultados entregables y no entregables
Aprenda a integrar la API de verificación de entregabilidad de correo para gestionar resultados entregables, no entregables y catch-all en sus flujos de trabajo.
Integre la API de Verificación de entregabilidad de correo para distinguir las direcciones entregables de las no entregables y de los dominios catch-all indeterminados en flujos de trabajo síncronos y masivos.
EmailCheckPro proporciona una API de verificación de entregabilidad de correo que determina si una dirección es entregable (puede recibir correo) o no entregable en el momento de la verificación. Un veredicto de entregable indica que la dirección puede aceptar mensajes en el momento de la comprobación, mientras que un veredicto de no entregable identifica una dirección que no puede recibir correo. El servicio evalúa direcciones en prácticamente cualquier dominio sin enviar mensajes a los destinatarios. Al integrar flujos de trabajo de API en tiempo real y masivos, los equipos de ingeniería pueden separar las direcciones de destinatarios activas de los registros no entregables y de los dominios catch-all indeterminados, mejorando la calidad de la transmisión y manteniendo la higiene de los datos en los sistemas de ingesta.
Veredictos principales de entregabilidad y alcance operativo
La evaluación de las direcciones de los destinatarios requiere distinciones claras entre los resultados entregables, no entregables e indeterminados.
Un veredicto de entregable confirma que la dirección del destinatario estaba accesible y preparada para recibir correo cuando se verificó. Por el contrario, un resultado de no entregable indica que la dirección no puede recibir mensajes. Ambos veredictos representan resultados de verificación completados.
Las evaluaciones de entregabilidad proporcionan señales de accesibilidad en un momento determinado, no garantías persistentes. Los equipos de desarrollo utilizan estas señales para eliminar direcciones inactivas de las colas de comunicación, lo que ayuda a proteger el rendimiento de la infraestructura y a respetar los principios europeos de minimización de datos según el GDPR Article 5 (Regulation (EU) 2016/679).
Integración síncrona para comprobaciones individuales y por lotes
Las aplicaciones que capturan datos de contacto durante el registro o la actualización de perfiles requieren una evaluación rápida y síncrona. EmailCheckPro proporciona dos endpoints dedicados en tiempo real para flujos de trabajo interactivos.
Para envíos individuales, los desarrolladores consultan POST /api/v1/check con una única dirección completa.
Al gestionar pequeños lotes de entradas de usuario, POST /api/v1/batch-check procesa de 1 a 100 direcciones de forma síncrona dentro de una única solicitud HTTP. La respuesta de verificación múltiple mantiene el orden exacto de la lista de entrada. Cada registro incluye una propiedad exists junto con los detalles de la verificación. En este esquema, exists=false indica que el servicio no generó un resultado completado para esa entrada, en lugar de un veredicto de no entregable. Esta distinción permite a los sistemas de ingesta reintentar problemas transitorios mientras filtran de forma segura las entradas confirmadas como no entregables.
Tareas masivas asíncronas para el procesamiento de listas
El mantenimiento de grandes archivos de bases de datos requiere una arquitectura de procesamiento asíncrono. Al auditar los almacenes de contactos, los sistemas envían trabajos de verificación a través de POST /api/v1/bulk-tasks.
Los envíos masivos aceptan archivos TXT o CSV estructurados que contienen una dirección de correo electrónico completa por línea. Durante la ingesta del archivo, la plataforma elimina automáticamente las líneas duplicadas y las entradas mal formadas, preparando una tarea limpia. Se aplican límites de recuento documentados por producto; los equipos deben revisar la documentación oficial para conocer los límites de tareas actuales.
Debido a que los trabajos masivos se ejecutan de forma asíncrona, las aplicaciones supervisan el progreso mediante GET /api/v1/bulk-tasks/{id}. Los flujos de trabajo del cliente deben consultar este endpoint con una frecuencia no superior a una vez cada 30 segundos. Una vez completado el procesamiento, el endpoint proporciona una result_url que enlaza a un archivo CSV que contiene cada identificador y su resultado activado. El enlace de descarga generado permanece válido durante 12 horas y se actualiza cada vez que se consulta el estado de esa tarea.
Gestión de catch-all indeterminados y excepciones de formato
Los conductos de calidad de datos fiables deben diferenciar entre fallos de entregabilidad explícitos y entradas ambiguas o mal formadas.
Según el RFC 5322: Internet Message Format, una dirección de correo electrónico consta de una parte local y un dominio unidos por un símbolo @. Si una entrada entrante carece de esta estructura, la API trata la carga útil como un formato no válido. Un formato no válido sigue siendo distinto de un veredicto de no entregable, ya que representa un fallo de sintaxis estructural.
Los servidores de correo catch-all presentan otra categoría operativa. Estos dominios aceptan mensajes dirigidos a cualquier nombre de usuario local arbitrario, lo que impide que el motor de verificación aísle de forma definitiva los buzones válidos. En lugar de adivinar, EmailCheckPro marca las configuraciones catch-all como indeterminadas. En la verificación en tiempo real, los dominios catch-all devuelven el código de estado 42200 sin un resultado completado. Las comprobaciones indeterminadas, no válidas y fallidas no generan cargos, lo que permite a los equipos dirigir los registros catch-all a colas de revisión independientes.
Preguntas frecuentes
¿Qué distingue un veredicto de no entregable de un resultado indeterminado?
Las comprobaciones en tiempo real para dominios catch-all devuelven el código de estado 42200 sin un veredicto completado, lo que deja estas direcciones sin facturar y disponibles para políticas de revisión independientes.
¿En qué se diferencian las solicitudes de API de verificación múltiple de las tareas masivas asíncronas?
Las llamadas de verificación múltiple utilizan POST /api/v1/batch-check para validar de 1 a 100 direcciones de forma síncrona, devolviendo los resultados directamente dentro de la respuesta HTTP mientras se conserva el orden de entrada. Las tareas masivas asíncronas utilizan POST /api/v1/bulk-tasks para procesar grandes listas TXT o CSV. Las tareas masivas se ejecutan sin conexión, requieren consultar GET /api/v1/bulk-tasks/{id} en intervalos de 30 segundos y generan un CSV descargable a través de una result_url válida durante 12 horas.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.