注册与激活 API

当开启注册（SIGN_ENABLE=true）时，XAI 提供自助注册能力。若开启安全防护（SAFE_ENABLE=true），将启用 IP/频次等风控策略。

—

流程概览

请求验证码：POST /x-sign（传邮箱）
校验并创建：POST /x-sign/verify（传邮箱+验证码）
或使用一键激活链接：GET /x-sign/activate?token=...（邮件内按钮）
激活成功后，系统会发送欢迎邮件，包含您的 XAI API Key

—

请求验证码

端点：POST /x-sign
Body：{"email": "[email protected]"}
风控：
- 单邮箱 2 分钟内仅可请求一次
- 开启安全防护时，同 IP 每日验证码请求上限为 10 次

示例：

curl -X POST https://api.xaixapi.com/x-sign \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

—

校验并创建账户

端点：POST /x-sign/verify
Body：{"email": "[email protected]", "code": "123456"}
成功后：立即创建账户并发送欢迎邮件（含密钥与控制台入口）。

curl -X POST https://api.xaixapi.com/x-sign/verify \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "code": "123456"}'

—

邮件一键激活

端点：GET /x-sign/activate?token=...
行为：校验 token（10 分钟有效），激活并创建账户，返回 Web 成功/失败页面。

—

常见返回

// 成功
{ "success": true, "message": "Verification code sent successfully" }

// 失败举例
{ "success": false, "message": "Email already registered" }
{ "success": false, "message": "Please wait before requesting another verification code" }
{ "success": false, "message": "Too many verification codes requested from this IP today" }

—

邮件模板与变量

验证码邮件包含激活链接（/x-sign/activate?token=...）。
欢迎邮件包含：Svc、Api、Manage、Docs 等入口，以及您的 SecretKey。