修狗云挂机 / API 文档OpenAPI JSON

API v0.1

本地开发演示模式使用合成账号;本地实测模式使用已配置的游戏适配器。

身份与权限

请求头:Authorization: Bearer <API 密钥>。每个密钥绑定一个用户;API 不接受指定他人用户 ID。密钥有效期 30 天,可随时撤销。创建和撤销密钥须使用网页登录会话。

浏览器写操作另需 X-CSRF-Token,由 GET /api/session 获取。导入只接受在客户端加密的 envelope,不能直接提交原始继承码或存档。

方法 路径 权限 请求 / 返回
GET/api/meaccounts:read当前用户、角色、等级、功能和账号上限
GET/api/accounts/{id}/detailaccounts:read游戏用户名、UID、货币与库存快照及同步时间
POST/api/accounts/{id}/syncaccounts:write仅登录同步库存,返回 id/state;详情接口中的 syncs 提供最近状态和错误码。无需启用每日计划,不占用领奖日。
GET/api/accounts/{id}/tasksaccounts:read轻量读取 syncs、team_updates 和 game_session;仅返回状态,不发起游戏请求。
PUT/api/accounts/{id}/sessionaccounts:write{"enabled": true/false} 开关后台会话保活。默认每 5 分钟只读探活;关闭后仍可按需复用已有会话。
GET/api/accounts/{id}/teamsaccounts:read已同步队伍、分组、成员与龙刻图片、版本指纹和保存记录;不发起游戏请求。
PUT/api/accounts/{id}/teams/{teamId}teams:writename、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-runruns:write按当前领取设置执行一次独立任务;支持计划暂停或今日已完成。连续点击复用执行中的任务。返回 id/state/kind,记录接口区分 manual 与 daily。
GET/api/accounts/{id}/farmingaccounts:read副本目录、已通关状态、出战队伍、执行队列、逐场结果和接入状态。可选 catalog_revision 使用上次返回的版本;catalog_unchanged=true 时保留已有目录并更新状态,省略稳定目录字段。主动刷新不传该参数。
POST/api/accounts/{id}/farmingruns:write{"action":"prepare_battle","floor":1,"team":1}:使用当前账号缓存构造战斗准备报告,返回每位成员的24字段完成度、来源及缺口。另需 auto_farm 功能,不登录游戏、不进关,不接受外部 aa 或令牌。
POST/api/accounts/{id}/farmingruns: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}/farmingruns: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 超过频率限制。原始游戏错误、凭证和网络响应不会返回给客户端。