GET /api/emails

查询邮箱列表。支持 status、limit、offset 参数，不返回密码和刷新令牌。

POST /api/emails/import

批量导入邮箱，每行格式为 email----password----client_id----refresh_token。

{
  "data": "a@example.com----password----client_id----refresh_token"
}

POST /api/emails/claim

原子锁定并返回一个可用邮箱。请求体为 {}。

{
  "id": 1,
  "email": "a@example.com",
  "password": "...",
  "client_id": "...",
  "refresh_token": "...",
  "lock_token": "uuid",
  "locked_at": "2026-09-23 10:00:00"
}

POST /api/emails/{id}/release

注册失败时释放邮箱锁。

{ "lock_token": "领取时返回的令牌" }

GET /api/cards

查询银行卡列表。卡号只显示最后四位，不返回 CVC。

POST /api/cards

添加银行卡。

{
  "card_number": "4242424242424242",
  "expiry_month": 12,
  "expiry_year": 2030,
  "cvc": "123",
  "holder_name": "Example User",
  "billing_address": "Billing address"
}

POST /api/cards/claim

原子锁定并返回一张可用银行卡的完整资料。请求体为 {}。

POST /api/cards/{id}/release

使用失败时释放银行卡锁。

{ "lock_token": "领取时返回的令牌" }

GET /api/snowflake-accounts

查询 Snowflake 账号列表。支持 limit 参数，不返回账号密码。

POST /api/snowflake-accounts

注册成功后回写 Snowflake 账号，并原子地将邮箱标记为已使用。重复提交相同结果会返回 idempotent: true。

{
  "email_id": 1,
  "email_lock_token": "邮箱锁令牌",
  "username": "user_name",
  "password": "snowflake-password",
  "account_name": "ORG-ACCOUNT",
  "host": "example.snowflakecomputing.com",
  "region": "us-east-1",
  "notes": "可选备注"
}

POST /api/snowflake-accounts/{id}/subscription

绑卡和订阅成功后进行第二次回写，并原子地将银行卡标记为已使用。相同账号与银行卡的重试是幂等的。

{
  "card_id": 1,
  "card_lock_token": "银行卡锁令牌",
  "subscription_status": "active",
  "subscription_plan": "Business Critical",
  "external_subscription_id": "sub_123",
  "notes": "可选备注"
}

GET /api/stats

返回邮箱、银行卡及 Snowflake 账号库存统计。

POST /api/auth/login

管理界面登录并签发 8 小时 HttpOnly Cookie。

{ "password": "管理员密码" }

POST /api/auth/logout

退出管理界面并清除 Cookie。

GET /api/auth/session

检查当前管理会话状态。