POST/api/public/access-request/email/verify

Comprueba el código enviado por correo electrónico y emite un token de confirmación para la posterior solicitud de acceso.

Envíe `verification_id` (de `start-verification`), la misma `email` y el `code` de seis cifras. Si tiene éxito, la respuesta contiene `verified: true` y un `verification_token` que enviará al presentar la solicitud de acceso mediante `POST /api/public/access-request`. Un código incorrecto o caducado, un `verification_id` que no coincide o una dirección de correo distinta producen 400 `VERIFY_FAILED`. En ese caso, solicite un nuevo código. El token solo es válido para esa dirección de correo y no debe aparecer en URL ni en registros. Como máximo 10 solicitudes cada 15 minutos por dirección IP.

Descripción general

Llamada: POST /api/public/access-request/email/verify. Este endpoint pertenece al grupo «Formularios públicos» de la API de Zentor App. Es de acceso público y no requiere autenticación. La llamada no es idempotente: cada llamada correcta vuelve a desencadenar la acción. Parámetros obligatorios: verification_id (body), email (body), code (body). Casos de error documentados: 400 VERIFY_FAILED. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.

Autenticación y seguridad

No se requiere autenticación

Idempotente: No

Parámetros

verification_id(body, string, obligatorio)— `verification_id` de `start-verification`
email(body, string, obligatorio)— La misma dirección de correo utilizada al solicitar el código
code(body, string, obligatorio)— Código de seis cifras del correo

Solicitud de ejemplo

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

Respuesta de ejemplo

{"ok":true,"verified":true,"verification_token":"<Token para la solicitud de acceso posterior>"}

Códigos de error

400 VERIFY_FAILED — El código, el `verification_id` o la dirección de correo son incorrectos, o el código ha caducado.

Comportamiento verificado

Un código incorrecto devuelve 400 `VERIFY_FAILED`. El caso de éxito corresponde a la confirmación por correo del configurador de producto.

Formularios públicos

POST /api/public/contactRecibe una solicitud del formulario de contacto del sitio web de Zentor App y la reenvía al equipo de Zentor.POST /api/public/consultationRecibe una solicitud de asesoramiento del formulario del sitio web de Zentor App.POST /api/public/access-requestEnvía una solicitud de acceso para un paquete (Starter, Individual o demo de 14 días). Se requiere una dirección de correo previamente confirmada.POST /api/public/access-request/email/start-verificationEnvía un código de confirmación de seis cifras, válido 10 minutos, a la dirección de correo indicada: el primer paso de una solicitud de acceso.GET /api/public/access-request/payment-statusIndica qué métodos de pago (PayPal, Stripe) están actualmente disponibles para la solicitud de acceso.GET /api/public/access-request/paypal/configDevuelve la configuración pública de PayPal (activo, modo, moneda) para el paso de pago.POST /api/public/access-request/paypal/create-orderCrea un pedido de PayPal para el paquete seleccionado.POST /api/public/access-request/paypal/capture-orderCompleta (captura) un pedido creado previamente y aprobado por el comprador en el checkout de PayPal. El importe lo fija exclusivamente el servidor.POST /api/public/access-request/stripe/create-checkoutCrea una sesión de pago de Stripe para el paquete seleccionado.POST /api/public/activate-accountActiva una cuenta de usuario recién creada y establece la primera contraseña, activado mediante el enlace del correo de invitación.

Artículos relacionados

← Formularios públicos