Compruebe direcciones de correo durante el registro

Cómo enviar la dirección desde el formulario

Para usar la API necesita una cuenta confirmada, una credencial creada en esa cuenta y saldo de créditos. El navegador puede comprobar el formato de la dirección, pero esa revisión no determina si puede recibir correo. Su servidor debe enviar la petición a Emvero; la credencial bearer debe permanecer allí, fuera del código del navegador.

La siguiente petición usa la verificación completa, que es la opción predeterminada:

curl -sS https://api.emvero.tech/v1/verifications \
  -H "Authorization: Bearer emv_your_credential" \
  -H "Content-Type: application/json" \
  -d '{"email":"ada@example.com"}'

La respuesta incluye un identificador (id), un estado (status), una acción recomendada (action), las comprobaciones realizadas (checks) y los códigos de motivo (reason_codes). Este fragmento es un ejemplo de respuesta, no el resultado de una consulta real a example.com:

{
  "id": "5f0b6f3e-1a4c-4a1f-9d2e-8f7b3c2a1d90",
  "status": "risky",
  "action": "allow_with_email_confirmation",
  "checks": { "syntax": "valid", "mail_routing": "valid", "accept_all": "yes" },
  "reason_codes": ["ACCEPT_ALL_DOMAIN"]
}

En el ejemplo, el dominio acepta cualquier destinatario: es un dominio catch-all. Esa aceptación no confirma que exista un buzón concreto. El estado risky refleja ese riesgo, y allow_with_email_confirmation recomienda continuar con confirmación por correo.

Otros resultados con el mismo estado pueden llevar una acción distinta. Su aplicación puede seguir la recomendación o aplicar reglas propias según las comprobaciones y los códigos de motivo. La página de la API de verificación de correo explica todos los campos de la respuesta.

Cómo responder al resultado en el formulario

Cuando la comprobación termina, action recomienda el paso siguiente. Mientras sigue en curso, status puede indicar pending. Conviene distinguir ambos campos al decidir qué muestra el formulario:

Recomendación o estado recibido	Posible respuesta del formulario
allow	Continuar el registro o la compra.
allow_with_email_confirmation	Continuar y pedir que la persona confirme la dirección por correo.
reject	Pedir que corrija la dirección o introduzca otra.
pending	Esperar dentro del plazo de la aplicación; si se agota, aplicar la alternativa prevista.

Los tres primeros valores pertenecen a action; pending pertenece a status y significa que aún no hay un resultado final. Si la comprobación termina con unknown, la información disponible no permite resolver la dirección. No debe tratarse como una dirección inválida. El campo confidence puntúa la solidez de las pruebas entre 0 y 1; no expresa la probabilidad de entrega.

Si se detecta un error en la dirección, la persona puede corregirlo antes de completar el registro. La guía de validación de formularios de registro explica cómo coordinar las comprobaciones del navegador, la petición del servidor y los mensajes del formulario.

Qué hacer mientras la comprobación sigue pendiente

Algunas comprobaciones del destinatario requieren más tiempo del que conviene hacer esperar a una persona. Una respuesta pending incluye el identificador de la verificación y retry_after_ms, el intervalo en milisegundos que debe esperar antes de consultar de nuevo. Este es un ejemplo de sus campos:

{
  "id": "5f0b6f3e-1a4c-4a1f-9d2e-8f7b3c2a1d90",
  "status": "pending",
  "retry_after_ms": 2000
}

Cuando termine el intervalo, consulte GET /v1/verifications/{id} con la misma credencial bearer. Si el estado sigue siendo pending, respete el nuevo intervalo antes de repetir la consulta. Emvero no envía notificaciones automáticas a su aplicación mediante callbacks: debe recuperar el resultado con estas peticiones. La documentación de resultados pendientes explica el procedimiento.

Fije un plazo de espera en el formulario. Si un paso requiere conocer el resultado final antes de continuar, manténgalo pendiente hasta obtenerlo o alcanzar ese plazo. En otros casos, puede permitir que el registro avance de forma provisional, pedir confirmación por correo y recuperar el resultado después. Conserve el identificador para poder hacerlo.

Agotar el plazo del formulario no convierte la respuesta en undeliverable ni hace que la verificación haya terminado. Un error de la API tampoco demuestra que la dirección sea inválida: indica un problema con la petición o con el servicio. Prevea cómo continuará el formulario en esos casos, sin mostrar un error de dirección que la comprobación no ha establecido.

Qué comprueba Emvero y qué demuestra la confirmación

Emvero revisa el formato de la dirección, el dominio y la ruta de correo. Una verificación completa también puede consultar al servidor receptor sobre el destinatario, siempre que el servidor lo permita. La sesión SMTP termina antes de DATA, por lo que no se envía ningún mensaje. La comprobación de dominio se detiene antes de SMTP y no confirma un buzón concreto.

El servidor receptor puede no proporcionar información suficiente sobre el buzón. Incluso una respuesta de aceptación no garantiza que un mensaje futuro se entregue o llegue a la bandeja de entrada.

La confirmación por correo permite comprobar que la persona tiene acceso al buzón en ese momento; su aplicación debe enviar ese mensaje por separado. No demuestra su identidad ni sustituye los controles contra bots, registros repetidos o fraude. Para comprobar direcciones que ya están guardadas en una lista, la verificación masiva usa el mismo modelo de resultados desde un proceso propio.