POST/api/public/access-request/email/verify

校验邮件中发送的代码,并为后续的访问申请发出确认令牌。

发送 `verification_id`(来自 `start-verification`)、相同的 `email` 以及六位数的 `code`。成功时,响应包含 `verified: true` 以及一个 `verification_token`,您需在通过 `POST /api/public/access-request` 提交访问申请时一并发送。 如果代码错误或已过期、`verification_id` 不匹配,或电子邮件地址不同,均会导致 400 `VERIFY_FAILED`。此时请申请一个新代码。该令牌仅对此电子邮件地址有效,不得出现在 URL 或日志中。 每个 IP 地址最多 15 分钟内 10 次请求。

概览

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

身份验证与安全

无需身份验证

幂等: 否

参数

verification_id(body, string,必填)— 来自 `start-verification` 的 `verification_id`
email(body, string,必填)— 与申请代码时相同的电子邮件地址
code(body, string,必填)— 邮件中的六位数代码

请求示例

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

响应示例

{"ok":true,"verified":true,"verification_token":"<用于后续访问申请的令牌>"}

错误代码

400 VERIFY_FAILED — 代码、`verification_id` 或电子邮件地址不正确,或代码已过期。

已验证的行为

错误代码返回 400 `VERIFY_FAILED`。成功情况对应产品目录的邮件确认。

公开表单

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/start-verification向指定的电子邮件地址发送一个有效期为 10 分钟的六位数确认码——这是访问申请的第一步。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激活新创建的用户账户并设置首个密码——通过邀请邮件中的链接触发。

相关文章

← 公开表单