LICENSE OPERATIONS
卡密管理
查看每张卡的使用状态,管理角色绑定与有效期。
| 卡密 / 备注 | 状态 | 发放情况 | 角色 | 到期时间 | 激活 / 换绑 | 操作 |
|---|
▤
这里还没有卡密
生成新卡,或将现有飞书卡密导入到这里。
到期状态按服务器时间即时计算。停用和时长调整会在客户端下次校验时生效。
| APK 文件名 | 文件大小 | 上传时间 | 下载地址 | 操作 |
|---|
⇩
这个游戏还没有 APK
选择该游戏的安装包上传,支持一次选择多个 APK。
按游戏名称分别保存;每个游戏可上传多个 APK。下载地址可直接分享。
授权与管理操作
| 时间(北京时间) | 卡片 ID | 操作 | 操作人 / 角色 ID | 详情 |
|---|
三个接口,完成授权闭环
接口地址:
POST
/v1/activate提交卡密、角色 ID、角色名与 request_id。角色绑定卡首次激活或同角色提交直接授权,其他角色返回换绑确认;通用卡任意角色直接授权。
POST
/v1/rebind玩家点击确认后,提交 offer_token、同一角色 ID / 名字与新的 request_id。服务端原子扣时并返回最新到期时间。
POST
查看 OpenAPI 定义 ↗/v1/verify携带 Authorization: Bearer session_token 和 role_id,每 90 秒校验。以响应中的到期时间更新显示与缓存。
当前授权规则
- 角色绑定卡同时绑定一个角色 ID;角色名字用于展示。
- 通用卡不绑定角色,可自由切换,不扣换绑时长;所有角色共享同一到期时间。
- 同角色可重复激活,不扣时、不重新开始计时。
- 限时卡换绑扣 24 小时,剩余 ≤24 小时拒绝。
- 永久卡确认后免费换绑。
- 确认凭证 120 秒有效,卡片变化后须重新确认。
- 修改请求超时后用原 request_id 重试,避免重复扣时。
- 客户端断网最多宽限 300 秒;明确拒绝应立即停权。
- 旧 APK 需要接入这些接口后才能使用此服务。
上线前先冻结旧端写入,再导入飞书数据并切换客户端。数据库应作为唯一授权来源。