POST/api/public/consultation

Formulario público de solicitud de asesoramiento del sitio web de Zentor.

`POST /api/public/consultation` procesa el formulario público de asesoramiento. La documentación de este endpoint debe entenderse como descripción técnica de esta operación concreta. Son determinantes método, ruta, autenticación, campos obligatorios, errores documentados e idempotencia. Zentor no dispone de un sistema general de API Keys para desarrolladores; las rutas públicas no necesitan esa clave y las rutas protegidas de widget utilizan el Embed Token documentado y validación de Origin. El estado HTTP y el cuerpo JSON deben evaluarse conjuntamente. Los errores de validación, recursos inexistentes, Origins rechazadas, valores de un solo uso caducados y errores de servidor requieren tratamientos distintos. Una solicitud correcta confirma únicamente este paso de procesamiento; no demuestra automáticamente la entrega de un correo, la finalización de un pago o un flujo SSO. Para las pruebas deben utilizarse datos anonimizados. Los ejemplos públicos no deben contener datos reales de clientes, UUID productivos, Session Tokens ni timestamps reales. El límite conocido de toda la plataforma es de 2.000 solicitudes por 15 minutos salvo que se documente expresamente un límite más estricto para esta ruta. Las llamadas POST no idempotentes no deben repetirse a ciegas tras una interrupción de red ambigua. Los errores devueltos deben registrarse sin almacenar secretos. La revisión técnica debe basarse en la Registry `app/frontend/src/content/api-reference/`, las rutas backend asociadas y las pruebas. Un test negativo o una analogía de código no constituye una verificación live completa.

Autenticación y seguridad

No se requiere autenticación

Idempotente: No

Parámetros

name(body, string, obligatorio)2–120 caracteres
email(body, string, obligatorio)Dirección de correo electrónico válida
company(body, string)
message(body, string)
phone(body, string)
consentGiven(body, boolean, obligatorio)Debe ser true

Solicitud de ejemplo

{"name":"Max Mustermann","email":"max@example.com","company":"Empresa de ejemplo","message":"Solicitud","consentGiven":true}

Respuesta de ejemplo

{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}

Códigos de error

400 VALIDATION_ERRORFalta un campo obligatorio/es inválido o falta el consentimiento.

Evidencia de prueba en vivo

Éxito (200) y caso negativo (400) verificados live.

Formularios públicos