账号库存系统

精品库存

总材料--
注册次数--
回传结果--
停用材料--
总数据库 每一行是一份原材料当前所在的位置
UUID 状态 平台 派发次数 最近派发 最近回传 是否锁定精品
第 1 页
接口工具 低频管理操作：导入、Token、调试回传
粘贴导入
文件导入
外部取号 Token
ID Token 名称 状态 最近使用 创建时间
调试回传
最近导入
批次号 来源 状态 总数 成功 失败 创建时间
第 1 页
领取记录--
本页成功--
本页冲突--
领取记录
记录 ID 账号 ID 结果 领取人 区服 分类 用途 金额 领取时间 状态
第 1 页
用户名
--
显示名
--
角色
--
今日领取
--
新建用户
权限矩阵
权限
ID 用户名 显示名 角色 状态 母账号 权限 操作
第 1 页
外部接口文档

认证

所有外部接口都必须携带管理员创建的 token。Token 明文只在创建时展示一次。

X-Callback-Token: cb_xxx

1. 连通性检查

用于验证 token 是否有效，以及服务是否可达。

GET /api/v1/external/ping
curl -H "X-Callback-Token: cb_xxx" \
  http://127.0.0.1:8000/api/v1/external/ping

2. 状态查询

用于查看取号规则、今日额度和原材料状态。

GET /api/v1/external/status
{
  "limits": {
    "max_once": 200,
    "max_daily": 10000,
    "pending_timeout_hours": 24
  },
  "today": {
    "dispatched": 1200,
    "remaining": 8800
  },
  "materials": {
    "available": 9800000,
    "pending": 120,
    "exception": 8,
    "premium_locked": 32
  }
}

3. 取号

下游按参数 x 提取 uuid 和 device_id。单次最多 200，全局每日最多 10000。

POST /api/v1/external/raw-material-dispatches.txt?x=100
curl -X POST -H "X-Callback-Token: cb_xxx" \
  "http://127.0.0.1:8000/api/v1/external/raw-material-dispatches.txt?x=100"

返回体每行由 uuid 和 device_id 组成，用制表符分隔：

626BDEC6-0C7A-FEF2-9AEA-74465C89C187	626BDEC6-0C7A-FEF2-9AEA-74465C89C187
726BDEC6-0C7A-FEF2-9AEA-74465C89C188	726BDEC6-0C7A-FEF2-9AEA-74465C89C188

取出后原材料进入 pending，回传前不会再次派发；超过 24 小时未回传会进入异常，由管理员手动处理。

4. 回传

下游完成跑区后按纯文本回传，每行一条。

POST /api/v1/external/registration-results.txt
Content-Type: text/plain
x-火线1015----626BDEC6-0C7A-FEF2-9AEA-74465C89C187----626BDEC6-0C7A-FEF2-9AEA-74465C89C187----[麟龙祈福·幻形_],[麟龙祈福·时装_],[璀璨宝箱钥匙*3],----1740663717

device_id 必须与取号时携带的 device_id 一致，否则回传会被拒绝。使用自定义 device_id 时必须使用 5 段格式；省略 device_id 时系统默认使用 uuid（仅当取号时未指定 device_id 或两者相同时有效）。

字段 说明
x-火线1015区服。火线暂按苹果，先锋暂按安卓。
uuid取号接口返回的原材料 uuid。
device_id设备唯一标识。命中精品后存入账号记录的 device_id 字段。
装备文本跑出来的装备、宝石、皮肤文字。
timestamp下游回传时间戳。

返回体：

total=100
accepted=98
premium=2
normal=96
failed=2

命中精品会进入精品库存并锁定原材料；未命中精品只记录统计，原材料恢复可派发。