账号库存系统

原材料

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

流程

  1. 上游软件取 sfz 做注册，注册后产出 uuid、device_id、时间戳。
  2. 总数据库入库，格式为 uuid----device_id----时间戳。
  3. 后台网站把总库数据复制到工作库，并把总库对应数据标识为已取走。
  4. 外部程序从工作库取号，返回 uuid----device_id。
  5. 外部程序按 区服----uuid----device_id----装备文本----时间戳 回传。
字段说明
sfz上游注册软件使用的材料，本系统当前入库接口不接收。
uuid注册后生成的游戏 UUID，取号和回传必须原样使用。
device_id注册设备生成的设备 ID，系统保存，取号和回传必须保持一致。
时间戳注册软件产出的时间，示例使用 Unix 秒级时间戳。

安卓/苹果渠道传法

渠道字段只在总库入库和工作库取号筛选时传；工作库回传不用传 source_channel，系统按 区服 判断。

场景安卓传法苹果传法
总库 API 文本入库"source_channel": "android_initial""source_channel": "ios_initial"
总库 txt 文件入库source_channel=android_initialsource_channel=ios_initial
工作库取号筛选?source_channel=android_initial?source_channel=ios_initial
工作库回传区服用先锋，例如 x-先锋100服区服用火线，例如 x-火线1015服

1. 总数据库入库

API 文本入库：

POST /api/v1/raw-material-imports
Content-Type: application/json
{
  "source_channel": "android_initial",
  "original_file_name": "android-raw-api.txt",
  "duplicate_strategy": "skip",
  "content": "626BDEC6-0C7A-FEF2-9AEA-74465C89C187----DID-001----1740663717"
}
字段说明
source_channel来源渠道；安卓传 android_initial，苹果传 ios_initial。
original_file_name文件名或批次标识。
duplicate_strategy重复处理策略：skip 跳过、overwrite 覆盖、fail 记失败。
content原材料文本，每行 uuid----device_id----时间戳。
行内字段说明
uuid游戏 UUID，系统保存为大写。
device_id设备 ID，系统保存；取号、回传必须原样带回。
时间戳注册产出时间戳，建议 Unix 秒级。

也可以上传 txt：

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

苹果 txt 入库时把 source_channel 改成 ios_initial。

2. 工作库取号

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

POST /api/v1/external/raw-material-dispatches.txt?x=100
参数说明
x单次取号数量，默认 100。
source_channel可选，只取指定来源渠道的数据；安卓传 android_initial，苹果传 ios_initial；不传表示不按渠道筛选。

按渠道取号示例：

POST /api/v1/external/raw-material-dispatches.txt?x=100&source_channel=android_initial
POST /api/v1/external/raw-material-dispatches.txt?x=100&source_channel=ios_initial

返回体每行：

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

返回字段：第一段是 uuid，第二段是 device_id，回传时必须原样带回。

3. 工作库回传

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

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

返回体：

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

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