API v0.1
本地开发演示模式使用合成账号;本地实测模式使用已配置的游戏适配器。
身份与权限
请求头:Authorization: Bearer <API 密钥>。每个密钥绑定一个用户;API 不接受指定他人用户 ID。密钥有效期 30
天,可随时撤销。创建和撤销密钥须使用网页登录会话。
浏览器写操作另需 X-CSRF-Token,由
GET /api/session 获取。导入只接受在客户端加密的
envelope,不能直接提交原始继承码或存档。
| 方法 | 路径 | 权限 | 请求 / 返回 |
|---|---|---|---|
| GET | /api/me | accounts:read | 当前用户、角色、等级、功能和账号上限 |
| GET | /api/accounts/{id}/detail | accounts:read | 游戏用户名、UID、货币与库存快照及同步时间 |
| POST | /api/accounts/{id}/sync | accounts:write | 仅登录同步库存,返回 id/state;详情接口中的 syncs 提供最近状态和错误码。无需启用每日计划,不占用领奖日。 |
| GET | /api/accounts/{id}/tasks | accounts:read | 轻量读取 syncs、team_updates 和 game_session;仅返回状态,不发起游戏请求。 |
| PUT | /api/accounts/{id}/session | accounts:write | {"enabled": true/false} 开关后台会话保活。默认每 5 分钟只读探活;关闭后仍可按需复用已有会话。 |
| GET | /api/accounts/{id}/teams | accounts:read | 已同步队伍、分组、成员与龙刻图片、版本指纹和保存记录;不发起游戏请求。 |
| PUT | /api/accounts/{id}/teams/{teamId} | teams:write | name、cards、crafts、chronon_cards、revision。三个位置数组均为 5 个背包实例编号,空位为 "0"。返回保存任务;详情接口 team_updates 提供执行结果。 |
| GET / POST / PUT | /api/admin/users / /{id} | 管理员浏览器 | 登记或修改用户,普通 API 密钥不能调用 |
| GET / PUT | /api/admin/tiers / /{id} | 管理员浏览器 | 等级、账号上限及功能设置 |
| GET / PUT | /api/admin/server-data | 管理员浏览器 | 共享表清单与更新记录;保存 enabled、interval_minutes(5–10080)。 |
| POST | /api/admin/server-data/refresh | 管理员浏览器 | 更新官方公开配置,返回队列 id/state;不发起游戏账号登录。 |
| GET | /api/admin/audit | 管理员浏览器 | 管理操作记录 |
| GET | /api/accounts |
accounts:read | 账号列表,不含凭证 |
| GET | /api/import-key |
accounts:write | owner、fingerprint、pem |
| POST | /api/accounts |
accounts:write | {"label":"备注","envelope":{…}} |
| PUT | /api/accounts/{id}/schedule |
schedule:write |
{"at":"00:10","zone":"Asia/Shanghai","enabled":true}
|
| POST | /api/accounts/{id}/run |
runs:write | 当日任务 id、state;重复请求返回同一任务 |
| PUT | /api/accounts/{id}/rewards |
schedule:write | {"limited":true,"target":false,"past":false,"force_expiring":false,"daily_missions":true,"event_missions":true,"quest_boards":true,"battle_pass":true}四类任务奖励默认开启。旧客户端只提交原四字段时保留任务开关。 |
| GET | /api/runs/{id} |
history:read | 逐项领取日志及已确认道具小结 |
| POST | /api/accounts/{id}/manual-run | runs:write | 按当前领取设置执行一次独立任务;支持计划暂停或今日已完成。连续点击复用执行中的任务。返回 id/state/kind,记录接口区分 manual 与 daily。 |
| GET | /api/accounts/{id}/farming | accounts:read | 副本目录、已通关状态、出战队伍、执行队列、逐场结果和接入状态。可选 catalog_revision 使用上次返回的版本;catalog_unchanged=true 时保留已有目录并更新状态,省略稳定目录字段。主动刷新不传该参数。 |
| POST | /api/accounts/{id}/farming | runs:write | {"action":"prepare_battle","floor":1,"team":1}:使用当前账号缓存构造战斗准备报告,返回每位成员的24字段完成度、来源及缺口。另需 auto_farm 功能,不登录游戏、不进关,不接受外部 aa 或令牌。 |
| POST | /api/accounts/{id}/farming | runs:write | 另需 auto_farm 等级功能。添加:{"action":"add","floor":1,"team":1,"repeats":1,"no_rank":true,"cleared_only":true};开始/暂停:action 为 start/pause;移除:action 为 cancel 并携带项目 id。当前真实进关返回待接入,合成模式可执行。 |
| POST | /api/accounts/{id}/farming | runs:write | 批量预览 / 导入:action 为 preview_batch / add_batch,携带 category(目录分类 key)、mode(all / uncleared / cleared)、team、team_revision、repeats、no_rank。预览返回数量、跳过原因与排序;提交会重新校验,超出容量整批拒绝,跳过队列中已有的关卡。 |
| POST | /api/accounts/{id}/pause |
schedule:write | 暂停后续任务 |
| GET | /api/accounts/{id}/history |
history:read | 最近 10 条记录 |
| GET | /api/runs |
history:read | 当前用户最近 100 条记录 |
| DELETE | /api/accounts/{id} |
accounts:write | 删除账号及其记录 |
| GET / POST | /api/tokens |
浏览器会话 | POST:{"scopes":["accounts:read"]} |
| DELETE | /api/tokens/{id} |
浏览器会话 | 立即撤销密钥 |
任务状态
queued → running → succeeded / already_claimed。uncertain
表示领奖结果未知,将暂停账号且不会自动重试该奖励日;核对后更新计划并传
acknowledge_review: true,仅恢复后续日期。
错误格式
{"code":"固定错误码"}。401 需重新认证,403 权限或 CSRF
不通过,404 账号不存在或不属于当前用户,429
超过频率限制。原始游戏错误、凭证和网络响应不会返回给客户端。