POST/api/public/access-request

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

Confirme primero la dirección de correo mediante `POST /api/public/access-request/email/start-verification` y `POST /api/public/access-request/email/verify`. Luego envíe `name`, el mismo `email`, el paquete `package` (`starter`, `individual` o `demo_access`) y el `verification_token` recibido. Opcionalmente se pueden enviar `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` o `stripe_sepa`), `wish` (`trial`, `subscription` u `offer`; siempre `trial` para el acceso de demo) y `message`. Sin una confirmación válida, el servidor responde 400 `EMAIL_NOT_VERIFIED`. La falta de campos obligatorios o valores inválidos para el paquete, método de pago o deseo producen 400 `VALIDATION_ERROR`. Cada solicitud correcta se crea como una nueva solicitud y la procesa Zentor; por ello no repita la llamada automáticamente. 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.

Descripción general

Llamada: POST /api/public/access-request. 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: name (body), email (body), package (body). Parámetros opcionales: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Casos de error documentados: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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

name(body, string, obligatorio)— Nombre, 2–120 caracteres
email(body, string, obligatorio)— Dirección de correo previamente confirmada mediante `/email/verify`
package(body, string, obligatorio)— Paquete: `starter`, `individual` o `demo_access`
company(body, string)— Empresa, máx. 160 caracteres (opcional)
phone(body, string)— Número de teléfono, máx. 40 caracteres (opcional)
companyWebsite(body, string)— Sitio web de la empresa, máx. 200 caracteres (opcional)
paymentMethod(body, string)— Método de pago: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` o `stripe_sepa` (opcional)
wish(body, string)— Deseo: `trial`, `subscription` u `offer`; siempre `trial` para `demo_access` (opcional)
message(body, string)— Mensaje, máx. 3000 caracteres (opcional)

Solicitud de ejemplo

{"name":"Juan Pérez","email":"max@example.com","package":"demo_access"}

Respuesta de ejemplo

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

Códigos de error

400 VALIDATION_ERROR — Falta un campo obligatorio, o el paquete, el método de pago o el deseo son inválidos.
400 EMAIL_NOT_VERIFIED — La dirección de correo no fue confirmada previamente mediante `/email/start-verification` y `/email/verify`, o el `verification_token` falta o es inválido.

Comportamiento verificado

Un cuerpo vacío devuelve 400 `VALIDATION_ERROR`; datos válidos sin dirección de correo confirmada devuelven 400 `EMAIL_NOT_VERIFIED`. El caso de éxito sigue el flujo documentado tras la confirmación del correo.

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