POST/api/public/access-request/email/start-verification
向指定的电子邮件地址发送一个有效期为 10 分钟的六位数确认码——这是访问申请的第一步。
将待确认的地址发送到 `email` 字段。响应包含 `verification_id`、`expires_in_minutes`(10)和 `resend_cooldown_seconds`(60)。将 `verification_id` 与相同的电子邮件地址及收到的代码一起用于 `POST /api/public/access-request/email/verify`。只有在等待时间结束后才能重新发送;请在您的界面中显示剩余时间。 若超出限制,端点会以 429 `RATE_LIMIT_EXCEEDED` 响应。若邮件无法送达,会以 502 `MAIL_NOT_SENT` 响应;此时请检查地址并稍后重试。
概览
调用:POST /api/public/access-request/email/start-verification。该端点属于 Zentor App API 的“公开表单”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:email (请求体)。 已记录的错误情况:429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT。 下方的示例响应展示了 JSON 格式的成功响应结构。
身份验证与安全
无需身份验证
每个 IP 地址最多 15 分钟内 10 次请求。此外,Zentor 的访问规则(IP、国家和电子邮件域名规则)也适用;被拒绝的调用将收到 403。
速率限制: 10 Anfragen pro 15 Minuten (IP-basiert)
幂等: 否
参数
email(body, string,必填)— 待确认的电子邮件地址请求示例
{"email":"max@example.com"}响应示例
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}错误代码
429 RATE_LIMIT_EXCEEDED — 此 IP 地址发出的请求过多。请稍候再申请新代码。502 MAIL_NOT_SENT — 无法通过邮件发送确认码。已验证的行为
该调用返回 200 并附带 `verification_id`,验证码会通过邮件发送;重复调用返回 429 `RATE_LIMIT_EXCEEDED`。
公开表单
POST /api/public/contact接收来自 Zentor App 网站联系表单的请求,并转发给 Zentor 团队。POST /api/public/consultation接收来自 Zentor App 网站表单的咨询请求。POST /api/public/access-request提交某个套餐(Starter、个性化或 14 天 Demo)的访问申请。前提条件是事先已确认的电子邮件地址。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激活新创建的用户账户并设置首个密码——通过邀请邮件中的链接触发。