POST/api/public/contact

接收来自 Zentor App 网站联系表单的请求,并转发给 Zentor 团队。

必填字段为 `name`(2–120 个字符)、`email`(有效的电子邮件地址)、`message`(10–3000 个字符)以及必须设为 `true` 的 `consentGiven`。可选发送 `company`、`phone` 和 `topic`。成功时,服务器以 `{"ok":true}` 和一条确认消息响应。 如果必填字段缺失或无效,或缺少同意,端点会以 400 `VALIDATION_ERROR` 响应;`details` 字段列出各项具体错误,以便您标记相应的输入字段。每次成功提交都会创建一个新请求。因此,请在收到响应前禁用提交按钮,不要自动重试该调用。 每个 IP 地址最多 15 分钟内 10 次请求。此外,Zentor 的访问规则(IP、国家和电子邮件域名规则)也适用;被拒绝的调用将收到 403。

概览

调用:POST /api/public/contact。该端点属于 Zentor App API 的“公开表单”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:name (请求体), email (请求体), message (请求体), consentGiven (请求体)。 可选参数:company (请求体), phone (请求体), topic (请求体)。 已记录的错误情况:400 VALIDATION_ERROR。 下方的示例响应展示了 JSON 格式的成功响应结构。

身份验证与安全

无需身份验证

幂等: 否

参数

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 — 必填字段缺失或无效,或缺少隐私同意。`details` 包含各项具体的错误信息。

已验证的行为

完整信息返回 200;缺少必填字段或缺少同意返回 400 `VALIDATION_ERROR`。

公开表单

POST /api/public/consultation接收来自 Zentor App 网站表单的咨询请求。POST /api/public/access-request提交某个套餐(Starter、个性化或 14 天 Demo)的访问申请。前提条件是事先已确认的电子邮件地址。POST /api/public/access-request/email/start-verification向指定的电子邮件地址发送一个有效期为 10 分钟的六位数确认码——这是访问申请的第一步。POST /api/public/access-request/email/verify校验邮件中发送的代码,并为后续的访问申请发出确认令牌。GET /api/public/access-request/payment-status指示当前访问申请可使用哪些支付方式(PayPal、Stripe)。GET /api/public/access-request/paypal/config返回支付步骤所需的公开 PayPal 配置(启用状态、模式、货币)。POST /api/public/access-request/paypal/create-order为所选套餐创建一个 PayPal 订单。POST /api/public/access-request/paypal/capture-order完成(捕获)之前创建并由买方在 PayPal 结账页面批准的订单。金额仅由服务器确定。POST /api/public/access-request/stripe/create-checkout为所选套餐创建一个 Stripe 结账会话。POST /api/public/activate-account激活新创建的用户账户并设置首个密码——通过邀请邮件中的链接触发。

相关文章

← 公开表单