En esta sección, vamos a explicar cómo realizar correctamente validaciones utilizando correos electrónicos, la lógica principal que realiza el servicio es la siguiente:
Solicitud de Validación de Correo Electrónico
Lo primero que debes hacer es solicitar un OTP para el correo electrónico. Esto se puede hacer utilizando el servicio de Solicitud de validación de correo electrónico. Es un método POST en el que envías cierta información de configuración para permitir que el correo electrónico se envíe correctamente a alguien en tu lista blanca. Aquí tienes un ejemplo de la información que debes proporcionar en el cuerpo:
URL
**POST - https://api.verifik.co/v2/email-validations**
Body
{
"project": "6266193db77ccc8111730c90",
"projectFlow": "658ed28b0990f300134d7b78",
"email": "[email protected]",
"type": "login",
"validationMethod": "verificationCode",
"language": "en"
}
Ahora explicaremos cada uno de estos parámetros y cómo enviarlos correctamente en la solicitud de la API:
- project: ID del proyecto, obtenido al generar un proyecto correctamente.
- projectFlow: ID del flujo del proyecto, obtenido al crear un flujo del proyecto correctamente.
- email: Correo electrónico que se someterá a validación; este correo electrónico debe ser real y tener una bandeja de entrada activa.
- type: Tipo de proceso que se llevará a cabo; las siguientes opciones están disponibles "login" u "onboarding". El tipo debe coincidir con el establecido en el flujo del proyecto.
- validationMethod: Método de validación; actualmente, se utiliza el parámetro "verificationCode", que genera una contraseña de un solo uso (OTP) para este proceso.
- language: Idioma en el que se enviará el correo electrónico de verificación; este parámetro consiste en abreviaturas de idiomas, por ejemplo, "es" para español y "en" para inglés.
Criterios de Éxito
Para que el servicio funcione correctamente, debes tener la siguiente información correctamente:
- Los parámetros project y projectFlow son reales y están relacionados, lo que significa que el proyecto contiene este projectFlow.
- El email está en tu lista blanca y tiene una bandeja de entrada.