注册 API

注册 API

自助注册通过激活链接完成:提交邮箱,收到邮件后打开链接确认,账号随即创建,API Key 显示在确认页面并通过欢迎邮件发送。注册接口无需认证。

export BASE_URL="https://api.xairouter.com"

自助注册可能被服务提供方关闭,此时所有 /x-sign 请求返回 403 {"success": false, "message": "Self-registration is currently disabled"}。

流程

  1. POST /x-sign:发送激活邮件,链接 10 分钟内有效。
  2. GET /x-sign/activate?token=...:打开确认页面,由用户点击确认。
  3. 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": "..."}。

相关文档