POST/api/public/contact

Zentor rupiitegua rehegua, oikuaa porãmbaregua ombojehegua. Ko'ã rupiitegua oikuaa porãmbaregua oñe'ẽva'erã, ha oñe'ẽtáva umi porãmbaregua ojehechakuaa porãva.

`POST /api/public/contact` procesa el formulario de contacto público del sitio web de Zentor y almacena la solicitud en el sistema interno de leads. El punto final no requiere autenticación de panel de control y no es idempotente. Cada envío exitoso puede generar un nuevo lead. Por lo tanto, el frontend debe desactivar el botón de enviar después del primer clic y no debe desencadenar repeticiones automáticas. Los campos obligatorios confirmados incluyen `name`, `email` y `message`. El nombre debe tener entre 2 y 120 caracteres, la dirección de correo electrónico debe tener un formato válido y el mensaje debe cumplir con las reglas de validación del lado del servidor. Solo se deben enviar otros campos si están previstos en el esquema real. No se deben utilizar valores desconocidos para controlar las propiedades internas del lead. Un formulario correcto verifica los campos obligatorios ya en el navegador, pero no depende exclusivamente de esa verificación. El servidor sigue siendo fundamental. En caso de un error de validación, la interfaz debe marcar el campo afectado y conservar el contenido ingresado. Un mensaje de éxito genérico solo debe aparecer después de una respuesta positiva del servidor. El formulario de contacto no es un canal seguro para contraseñas, claves de API, tokens de widgets, datos de pago o registros completos de datos de clientes. Los usuarios deben indicar el caso de uso, el producto afectado y una dirección de correo electrónico comercial alcanzable. En caso de un problema técnico, el nombre del inquilino, el momento, la función afectada y los pasos reproducibles ayudan sin transmitir contenido personal innecesario. Un flujo realista: el visitante completa el nombre, el correo electrónico y el mensaje, confirma las advertencias de privacidad de la página si corresponde y envía el formulario. El servidor valida los datos, crea el lead y proporciona una respuesta de éxito. Con un correo electrónico no válido o un nombre demasiado corto, no se genera un lead completo. El punto final no crea un inquilino, no reserva un paquete y no reemplaza la configuración estructurada del producto ni el proceso de asesoramiento. Para protegerse contra el spam y las solicitudes automatizadas en serie, el cliente debe respetar los errores del lado del servidor y no iniciar bucles infinitos inmediatos. Una respuesta exitosa solo debe borrar los campos de entrada cuando el servidor haya confirmado la aceptación. Si no llega la respuesta, el usuario puede guardar el contenido y volver a enviarlo de manera controlada más tarde. Para la asignación interna, el mensaje debe contener el motivo real, sin frases de marketing ni archivos adjuntos confidenciales. Un asunto claro y una descripción precisa del problema reducen las consultas. Sin embargo, la API en sí no asigna una prioridad garantizada ni confirma un plazo fijo de procesamiento.

Auth & Absicherung

Keine Authentifizierung erforderlich

Idempotent: Nein

Parameter

name(body, string, erforderlich)2 pe'ỹgua ha'e 120 pe'ỹgua.
email(body, string, erforderlich)E-mail ñepyrũ rehegua oikotevẽ.
message(body, string, erforderlich)10 peve 3000 peve.
company(body, string)
phone(body, string)
topic(body, string)
consentGiven(body, boolean, erforderlich)Ipy'ỹme, "true" ojeguereko (pytendasy ojapo'ỹre).

Beispiel-Request

{"name":"Max Mustermann","email":"max@example.com","message":"Mba'eichapa (ha'e poravo 10 letra térã).","consentGiven":true}

Beispiel-Response

{"ok":true,"message":"Pekoje'ova hese rupi'a, peiporandu ojehechakuaa."}

Fehlercodes

400 VALIDATION_ERROROjeguerekua'ỹ ojehechakuaa térã oñe'ẽhecharã, térã oñe'ẽta hesejehegua oñe'ẽva'erã (detallevo rupi ojehechakuaa ha'e oje'ẽva'erã).

Live-Test-Nachweis

Ohechauka (200) ha'e, ha'e ohechauka py'aguasu (400, peteĩguaivegua rupive, ha'e peteĩ ñemoñe'ẽ rupive). Ko'ẽgua ojehechakuaa'ỹre.

Formulário rupi'ỹgua.