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,字段缺失,包括缺少同意)已实时验证。