POST/api/public/access-request/email/start-verification

Enví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.

Envíe la dirección a confirmar en el campo `email`. La respuesta contiene `verification_id`, `expires_in_minutes` (10) y `resend_cooldown_seconds` (60). Use el `verification_id` junto con la misma dirección de correo y el código recibido en `POST /api/public/access-request/email/verify`. Solo se puede reenviar un código tras expirar el tiempo de espera; muestre el tiempo restante en su interfaz. Si se supera el límite, el endpoint responde 429 `RATE_LIMIT_EXCEEDED`. Si el correo no se puede entregar, responde 502 `MAIL_NOT_SENT`; en ese caso, verifique la dirección e inténtelo más tarde.

Descripción general

Llamada: POST /api/public/access-request/email/start-verification. 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: email (body). Casos de error documentados: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. La respuesta de ejemplo siguiente muestra la estructura de una respuesta correcta en formato JSON.

Autenticación y seguridad

No se requiere autenticación

Como máximo 10 solicitudes cada 15 minutos por dirección IP. Además, se aplican las reglas de acceso de Zentor (reglas de IP, país y dominio de correo electrónico); las llamadas rechazadas reciben 403.

Límite de solicitudes: 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotente: No

Parámetros

email(body, string, obligatorio)— Dirección de correo a confirmar

Solicitud de ejemplo

{"email":"max@example.com"}

Respuesta de ejemplo

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Códigos de error

429 RATE_LIMIT_EXCEEDED — Demasiadas solicitudes desde esta dirección IP. Espere antes de solicitar un nuevo código.
502 MAIL_NOT_SENT — El código de confirmación no se pudo entregar por correo electrónico.

Comportamiento verificado

La llamada devuelve 200 con un `verification_id`, y el código se envía por correo; las llamadas repetidas devuelven 429 `RATE_LIMIT_EXCEEDED`.

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/verifyComprueba el código enviado por correo electrónico y emite un token de confirmación para la posterior 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