账号库存系统

原材料

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

流程

  1. 后台登录拿 sid Cookie 和 csrf_token。
  2. 总数据库入库，格式为 uuid----device_id----时间戳。
  3. 从总数据库复制一批数据到工作库，数量用 x 控制。
  4. 后台创建 X-Callback-Token，交给外部程序保存。
  5. 外部程序从工作库取号，返回 uuid----device_id。
  6. 外部程序按 区服----uuid----device_id----装备文本----时间戳 回传。

后台写操作使用 X-CSRF-Token 校验；外部程序只需要 X-Callback-Token，不需要登录和 CSRF。

1. 后台登录拿 CSRF

POST /api/v1/auth/login
Content-Type: application/json
{"username":"<后台账号>","password":"<后台密码>"}

响应里的 csrf_token 后续放到 X-CSRF-Token，同时保留登录 Cookie。

2. 总数据库入库

API 文本入库：

POST /api/v1/raw-material-imports
Cookie: sid=...
X-CSRF-Token: <csrf_token>
Content-Type: application/json
{
  "duplicate_strategy": "skip",
  "content": "626BDEC6-0C7A-FEF2-9AEA-74465C89C187----DID-001----1740663717"
}

也可以上传 txt：

POST /api/v1/raw-material-import-files
file=@raw-materials.txt

3. 复制到工作库

POST /api/v1/raw-materials/copy-to-working?x=100
Cookie: sid=...
X-CSRF-Token: <csrf_token>

工作库的数据来源只有总数据库复制，复制数量用 x 控制。

4. 创建外部程序 Token

POST /api/v1/callback-tokens
Cookie: sid=...
X-CSRF-Token: <csrf_token>
Content-Type: application/json
{"token_name":"tongge-runner"}

返回的 token 只显示一次，外部程序后续放到请求头 X-Callback-Token。

5. 工作库取号

外部程序调用，单次提取数量用 x 控制。

POST /api/v1/external/raw-material-dispatches.txt?x=100
X-Callback-Token: <callback_token>

返回体每行：

626BDEC6-0C7A-FEF2-9AEA-74465C89C187----DID-001
3E8BC0D9-7288-4A55-A115-5B3772B5F09D----DID-002

6. 工作库回传

外部程序完成后按纯文本回传，每行一条。x 如果传了，必须等于正文非空行数。

POST /api/v1/external/registration-results.txt?x=1
X-Callback-Token: <callback_token>
Content-Type: text/plain; charset=utf-8
x-火线1015服----626BDEC6-0C7A-FEF2-9AEA-74465C89C187----DID-IOS-001----[麟龙祈福·幻形_],[麟龙祈福·时装_]----1740663717
字段 说明
区服火线识别为苹果，先锋识别为安卓。
uuid取号接口返回的 uuid。
device_id取号接口返回的设备 ID，必须原样回传并保存。
装备文本跑出来的装备、宝石、皮肤文字。
timestamp下游回传时间戳。

返回体：

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

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