POST/api/public/access-request

提交某个套餐(Starter、个性化或 14 天 Demo)的访问申请。前提条件是事先已确认的电子邮件地址。

首先通过 `POST /api/public/access-request/email/start-verification` 和 `POST /api/public/access-request/email/verify` 确认电子邮件地址。然后发送 `name`、相同的 `email`、套餐 `package`(`starter`、`individual` 或 `demo_access`)以及收到的 `verification_token`。可选发送 `company`、`phone`、`companyWebsite`、`paymentMethod`(`paypal`、`kreditkarte`、`rechnung`、`stripe_card` 或 `stripe_sepa`)、`wish`(`trial`、`subscription` 或 `offer`;申请演示访问时始终为 `trial`)以及 `message`。 若没有有效确认,服务器会以 400 `EMAIL_NOT_VERIFIED` 响应。缺少必填字段,或套餐、支付方式、意向的值无效,会导致 400 `VALIDATION_ERROR`。每个成功的申请都会被新建并由 Zentor 处理,因此请不要自动重试该调用。 每个 IP 地址最多 15 分钟内 10 次请求。此外,Zentor 的访问规则(IP、国家和电子邮件域名规则)也适用;被拒绝的调用将收到 403。

概览

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

身份验证与安全

无需身份验证

幂等: 否

参数

name(body, string,必填)— 姓名,2–120 个字符
email(body, string,必填)— 此前已通过 `/email/verify` 确认的电子邮件地址
package(body, string,必填)— 套餐:`starter`、`individual` 或 `demo_access`
company(body, string)— 公司,最多 160 个字符(可选)
phone(body, string)— 电话号码,最多 40 个字符(可选)
companyWebsite(body, string)— 公司网站,最多 200 个字符(可选)
paymentMethod(body, string)— 支付方式:`paypal`、`kreditkarte`、`rechnung`、`stripe_card` 或 `stripe_sepa`(可选)
wish(body, string)— 意向:`trial`、`subscription` 或 `offer`;`demo_access` 时始终为 `trial`(可选)
message(body, string)— 留言,最多 3000 个字符(可选)

请求示例

{"name":"张三","email":"max@example.com","package":"demo_access"}

响应示例

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

错误代码

400 VALIDATION_ERROR — 必填字段缺失,或套餐、支付方式或意向无效。
400 EMAIL_NOT_VERIFIED — 电子邮件地址未事先通过 `/email/start-verification` 和 `/email/verify` 确认,或 `verification_token` 缺失或无效。

已验证的行为

空请求体返回 400 `VALIDATION_ERROR`;没有已确认电子邮件地址的有效数据返回 400 `EMAIL_NOT_VERIFIED`。成功情况遵循邮件确认后的文档说明流程。

公开表单

POST /api/public/contact接收来自 Zentor App 网站联系表单的请求,并转发给 Zentor 团队。POST /api/public/consultation接收来自 Zentor App 网站表单的咨询请求。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激活新创建的用户账户并设置首个密码——通过邀请邮件中的链接触发。

相关文章

← 公开表单