Skip to main content

Validaciones de Email

Descripción​

Las Validaciones de Email son el sistema central de verificación dentro de Verifik que procesa y valida direcciones de email de los usuarios durante los procesos de autenticación y registro. Piénsalas como el punto de control de seguridad que asegura que los usuarios son quienes dicen ser verificando la titularidad del email mediante códigos de verificación seguros.

Cómo funcionan las Validaciones de Email​

Cada Validación de Email representa una sesión única de verificación que procesa direcciones de email proporcionadas por el usuario. Cuando alguien ingresa su email durante el registro, inicio de sesión o verificación de cuenta, Verifik crea una Validación de Email para enviar un código de verificación seguro y confirmar la titularidad del email del usuario.

Actualmente, las Validaciones de Email admiten estos tipos:

  • validation - Proceso estándar de verificación de email
  • login - Verificación de email para autenticación de usuarios
  • onboarding - Verificación de email para registro de nuevos usuarios
  • oneTimeLink - Verificación mediante enlace de acceso de un solo uso

Qué registran las Validaciones de Email​

Las Validaciones de Email son sistemas de verificación integrales que procesan todos los aspectos de la verificación por email:

Información del email​

  • Dirección de email y verificación de titularidad
  • Nombre del usuario y datos de contacto
  • Asociación con proyecto y cliente
  • Método de verificación y configuraciones de seguridad

Proceso de verificación​

  • Generación y envío de contraseñas de un solo uso (OTP)
  • Estado de envío de email y confirmación de entrega
  • Validación de código e intentos de verificación
  • Gestión de expiración y seguridad

Funciones de seguridad​

  • Limitación de tasa y prevención de abuso
  • Generación y validación segura de códigos
  • Seguimiento de entrega y confirmación
  • Detección y prevención de fraude

Endpoints de la API​

Crear una Validación de Email​

POST https://api.verifik.co/v2/email-validations

Listar todas las Validaciones de Email​

GET https://api.verifik.co/v2/email-validations

Recuperar una Validación de Email​

GET https://api.verifik.co/v2/email-validations/{validationId}

Validar una Validación de Email​

POST https://api.verifik.co/v2/email-validations/{validationId}/validate

Estructura del Objeto Validación de Email​

{
    "id": "email_validation_123456789",
    "email": "user@example.com",
    "status": "completed",
    "type": "validation",
    "verificationCode": "123456",
    "attempts": 1,
    "maxAttempts": 3,
    "expiresAt": "2024-01-15T11:30:00Z",
    "deliveryStatus": "delivered",
    "validatedAt": "2024-01-15T10:32:00Z",
    "createdAt": "2024-01-15T10:30:00Z"
}

Casos de uso​

  • Autenticación de usuarios: Verifica la titularidad del email para un inicio de sesión seguro
  • Registro de cuentas: Confirma direcciones de email durante el registro
  • Restablecimiento de contraseña: Verifica la titularidad del email para recuperación de contraseña
  • Seguridad: Mejora la seguridad de la cuenta mediante verificación por email