POST/api/public/contact

Zentor 网站的公开联系表单。在内部潜在客户系统中创建咨询。

`POST /api/public/contact` 处理 Zentor 网站的公开联系表单,并将请求录入内部潜在客户系统。该端点无需仪表板身份验证,且不具备幂等性。每次成功提交均可能生成一个新的潜在客户。因此,前端应在首次点击后禁用发送按钮,并避免触发自动重试。 已确认的必填字段包括 `name`、`email` 和 `message`。姓名长度需在 2 至 120 个字符之间,电子邮件地址必须格式有效,消息内容需符合服务器端验证规则。其他字段仅在真实 Schema 中定义时才允许发送。不应使用未知值来控制内部潜在客户属性。 正确的表单应在浏览器端验证必填字段,但绝不能仅依赖此验证。以服务器验证为准。若出现验证错误,界面应标记相关字段并保留用户输入。只有在收到服务器的成功响应后,才能显示通用的成功消息。 联系表单不是传输密码、API 密钥、小部件令牌、支付数据或完整客户记录的安全渠道。用户应说明应用场景、涉及的产品以及可联系的业务邮箱。若遇到技术问题,提供租户名称、时间点、受影响的功能及可复现的步骤将大有裨益,同时无需传输不必要的个人信息。 典型流程如下:访客填写姓名、电子邮件和消息,必要时确认网站的隐私政策,然后提交表单。服务器验证数据、创建潜在客户并返回成功响应。若电子邮件无效或姓名过短,则不会生成完整的潜在客户。该端点不会创建租户、预订套餐,也不会替代结构化的产品配置或咨询流程。 为防止垃圾邮件和自动化批量请求,客户端应尊重服务器端错误,切勿立即启动死循环。只有在服务器确认接收后,才应清空输入字段。若服务器无响应,用户可保存内容并在稍后受控地重新发送。 用于内部分配的消息应包含实际事由,避免营销套话或机密附件。清晰的标题和精确的问题描述可减少后续询问。但 API 本身并不保证优先级,也不确认固定的处理期限。

身份验证与安全

无需身份验证

幂等: 否

参数

name(body, string,必填)— 2–120 个字符
email(body, string,必填)— 有效的电子邮件地址
message(body, string,必填)— 10–3000 个字符
company(body, string)
phone(body, string)
topic(body, string)
consentGiven(body, boolean,必填)— 必须为 true(隐私同意)

请求示例

{"name":"Max Mustermann","email":"max@example.com","message":"您的消息(至少 10 个字符)","consentGiven":true}

响应示例

{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}

错误代码

400 VALIDATION_ERROR — 缺少必填字段或无效,或缺少隐私同意(包含单个错误消息的详情数组)。

实时测试证明

成功(200)与失败场景(400,字段缺失,包括缺少同意)已实时验证。

← 公共表单