POST/api/public/contact
Recibe una solicitud del formulario de contacto del sitio web de Zentor App y la reenvía al equipo de Zentor.
Los campos obligatorios son `name` (2–120 caracteres), `email` (dirección de correo válida), `message` (10–3000 caracteres) y `consentGiven`, que debe establecerse en `true`. Opcionalmente se pueden enviar `company`, `phone` y `topic`. Si tiene éxito, el servidor responde con `{"ok":true}` y un mensaje de confirmación. Si falta un campo obligatorio, es inválido o falta el consentimiento, el endpoint responde 400 `VALIDATION_ERROR`; el campo `details` enumera los errores individuales, de modo que pueda señalar los campos afectados. Cada envío correcto crea una nueva solicitud. Por ello, desactive el botón de envío hasta recibir la respuesta y 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/contact. 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), message (body), consentGiven (body). Parámetros opcionales: company (body), phone (body), topic (body). Casos de error documentados: 400 VALIDATION_ERROR. 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 caracteresemail(body, string, obligatorio)— Dirección de correo válidamessage(body, string, obligatorio)— Mensaje, 10–3000 caracterescompany(body, string)— Empresa (opcional)phone(body, string)— Número de teléfono (opcional)topic(body, string)— Tema de la consulta (opcional)consentGiven(body, boolean, obligatorio)— Consentimiento de protección de datos, debe ser `true`Solicitud de ejemplo
{"name":"Max Mustermann","email":"max@example.com","message":"Su mensaje (mín. 10 caracteres).","consentGiven":true}Respuesta de ejemplo
{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}Códigos de error
400 VALIDATION_ERROR — Falta un campo obligatorio o es inválido, o falta el consentimiento de protección de datos. `details` contiene los mensajes de error individuales.Comportamiento verificado
Los datos completos devuelven 200; los campos obligatorios faltantes o la falta de consentimiento devuelven 400 `VALIDATION_ERROR`.
Formularios públicos
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.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.