📧 账号查询与取号

使用邮箱查询账号，或使用取号码取号

🔍 查询：在已出成品号中精确搜索邮箱 🎫 取号：使用取号码随机取号（优先老号）

⚙️ 管理控制台

管理所有 Google 账号

📊
0 总账号数
📁
0 分组数量
🏷️
0 标签数量
👨‍👧‍👦
0 母号数量
选择分组
选择标签

📥 批量导入账号

💡 智能识别：自动识别分隔符和格式，支持混合导入
• 分隔符优先级：---- > --- > -- > Tab > 多空格
• 基础：账号--密码
• 格式3：账号--密码--2FA
• 格式1：账号--密码--辅助邮箱--2FA（第3字段含@）
• 格式2：账号--密码--2FA--API链接（第4字段含http）
• 完整版：账号--密码--辅助邮箱--2FA--API链接（5个字段）

➕ 添加新分组

🔗 母子号关联管理

每个母号最多可绑定 5 个子号，便于家庭组管理

👑 选择母号
选择分组
未选择母号
➡️
👶 选择子号
选择分组
未选择子号

📋 已关联的母子号

🔍 去重管理

扫描所有分组中的重复邮箱，确保号池数据唯一性

0
总账号数
0
重复邮箱
0
多余记录
🔍

点击"扫描重复"开始检测

系统将扫描所有分组中的重复邮箱

🎫 取号码管理

生成取号码供用户取号，每个取号码只能使用一次，取号优先分配老号

可用: 0 已用: 0

🔑 API Key管理

创建和管理外部API访问密钥，用于其他项目集成取号功能

📋 API使用日志

查看所有API调用记录，支持按操作类型筛选

共 0 条记录 当前页: 1 / 1

📖 API接口文档

外部系统集成指南

🔐 认证方式

所有API请求需要在Header中携带API Key：

X-API-Key: your_api_key_here

或者通过URL参数传递：

?key=your_api_key_here

📊 查询所有分组统计

GET
/api/external/stats

返回示例：

{
  "success": true,
  "stats": {
    "total": 100,
    "groups": [
      { "id": "xxx", "name": "未出成品号", "count": 50 },
      { "id": "yyy", "name": "已出成品号", "count": 30 }
    ],
    "ungrouped": 5
  }
}

📊 查询单一分组统计

GET
/api/external/stats/{分组名称}

示例：/api/external/stats/未出成品号

返回示例：

{
  "success": true,
  "groupName": "未出成品号",
  "count": 50
}

🎫 获取成品号

POST
/api/external/fetch/finished

从"未出成品号"分组取号，自动移入"已出成品号"

返回示例：

{
  "success": true,
  "account": {
    "email": "example@gmail.com",
    "password": "xxx",
    "recoveryEmail": "backup@gmail.com",
    "twoFactorKey": "ABCD1234",
    "apiLink": ""
  },
  "code": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
  "viewLink": "/v/xxxxxxxxxxxxxxxxxxxxxxxxxx",
  "expiresAt": 1234567890000,
  "message": "取号成功！账号已移入已出成品号"
}

🎫 获取资格号

POST
/api/external/fetch/qualified

从"未出资格号"分组取号，自动移入"已出资格号"

🎫 获取无资格号

POST
/api/external/fetch/unqualified

从"无资格"分组取号，自动移入"已出无资格号"

🔍 通过取号码查询账号

GET
/api/external/account/{取号码}

返回取号码对应的账号信息

↩️ 撤回取号 NEW

POST
/api/external/revoke

撤回已取出的账号，将账号移回原分组并清理相关记录

请求参数 (JSON)：

{
  "type": "finished",     // 必填: finished/qualified/unqualified
  "email": "xxx@gmail.com" // 或 "code": "取号码" (二选一)
}

分组映射：

  • finished: 已出成品号 → 未出成品号 (删除取号码)
  • qualified: 已出资格号 → 未出资格号
  • unqualified: 已出无资格号 → 无资格

返回示例：

{
  "success": true,
  "message": "撤回成功！账号已移回\"未出成品号\"",
  "account": { "email": "xxx@gmail.com" },
  "details": {
    "type": "finished",
    "fromGroup": "已出成品号",
    "toGroup": "未出成品号",
    "codeDeleted": true
  }
}

⚠️ 需要 revoke 权限

❌ 错误响应

{
  "error": "错误描述"
}

常见错误码：

  • 401 - API Key无效或已禁用
  • 403 - 无权限执行此操作
  • 404 - 资源不存在（如分组中无可用账号）
  • 400 - 请求参数错误

💡 使用示例 (curl)

# 查询统计
curl -H "X-API-Key: your_key" http://your_domain/api/external/stats

# 获取成品号
curl -X POST -H "X-API-Key: your_key" http://your_domain/api/external/fetch/finished

# 获取资格号
curl -X POST -H "X-API-Key: your_key" http://your_domain/api/external/fetch/qualified

# 撤回取号 (通过邮箱)
curl -X POST -H "X-API-Key: your_key" -H "Content-Type: application/json" \
  -d '{"type":"finished","email":"xxx@gmail.com"}' \
  http://your_domain/api/external/revoke

# 撤回取号 (通过取号码)
curl -X POST -H "X-API-Key: your_key" -H "Content-Type: application/json" \
  -d '{"type":"finished","code":"取号码"}' \
  http://your_domain/api/external/revoke
v1.1