注册 API
注册 API
自助注册通过激活链接完成:提交邮箱,收到邮件后打开链接确认,账号随即创建,API Key 显示在确认页面并通过欢迎邮件发送。注册接口无需认证。
export BASE_URL="https://api.xairouter.com"自助注册可能被服务提供方关闭,此时所有 /x-sign 请求返回 403 {"success": false, "message": "Self-registration is currently disabled"}。
流程
POST /x-sign:发送激活邮件,链接 10 分钟内有效。GET /x-sign/activate?token=...:打开确认页面,由用户点击确认。POST /x-sign/activate:创建账号,页面显示 API Key,并发送欢迎邮件。
打开链接(GET)只显示确认页面,不会创建账号,以免邮件安全扫描器预取链接造成误激活。
发送激活邮件
curl -X POST "$BASE_URL/x-sign" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "referral_code": "pk-Xvs..."}'| 字段 | 必填 | 说明 |
|---|---|---|
email | 是 | 邮箱,自动转为小写 |
referral_code | 否 | 推荐人的公开标识(pk-Xvs...,推荐人可从 GET /dashboard/status 的 public_key 获取) |
请求体不得超过 64 KiB。成功响应:
{"success": true, "message": "Verification code sent successfully", "data": {"email": "[email protected]"}}所有响应都是 {"success", "message", "data"} 结构。业务错误返回 400,message 为原因:
message | 原因 |
|---|---|
Invalid email address | 邮箱格式不正确 |
Email domain is not allowed for self-registration | 该邮箱域名不允许自助注册 |
Email already registered | 邮箱已注册 |
invalid referral code | 推荐码不存在或推荐人已停用 |
Please wait before requesting another verification code | 同一邮箱 2 分钟内重复请求 |
Too many verification codes requested from this IP today | 同一 IP 当日请求过多 |
Failed to send verification email | 邮件发送失败,请稍后重试 |
激活
激活邮件中的链接为 https://api.xairouter.com/x-sign/activate?token=<48 位令牌>。
GET /x-sign/activate?token=...:返回 HTML 确认页面。POST /x-sign/activate(表单字段token):创建账号并返回 HTML 成功页,页面显示新账号的 API Key。- 令牌无效或过期时显示
Invalid or expired activation link。
创建的账号:
| 属性 | 值 |
|---|---|
| 账号名 | 随机生成的系统名 |
| 显示名 | 由邮箱前缀生成 |
| API Key | 新生成的 51 位 sk-Xvs Key,另生成公开标识 pk-Xvs... |
| 注册赠金 | 数额由服务提供方设定,有效期 1 个月,在 GET /dashboard/info 的 credit_balance 中以 Sign-up bonus 标注 |
| 子账号名额 | 1 |
新账号的 Level、Role、价格与限速继承所属服务的默认设置。
反滥用保护
注册接口按来源 IP 限制频率。POST /x-sign 与 POST /x-sign/activate 共享以下限制:
| 限制 | 值 |
|---|---|
| 每分钟 / 每小时 / 每天请求数 | 3 / 10 / 20 |
| 每 IP 每天不同邮箱数 | 5(仅在 POST /x-sign 中检查,超限返回 400) |
| 渐进延迟 | 同一小时内请求越多,响应等待越久(最长 15 秒) |
| 自动封禁 | 可疑行为累计达到阈值后,该 IP 被封禁 3 小时 |
被频率或全站配额拒绝时返回 429,正文为 {"success": false, "message": "..."}。