给工具作者
公开 API
我做这个是为了让你们给 Broken Oath 做天梯站、装备库和 Meta 页面。它是放在 CDN 上的一组纯 JSON 文件,每小时重建一次。没有密钥,不用登录,直接下载文件即可。只读,任何东西都无法写入。
基础地址:https://clqwoilqnxutwsvdlrth.supabase.co/storage/v1/object/public/public-api/v1/
接口
index.json数据结构、generated_at、游戏版本、补丁、联赛 id,以及本补丁游戏数据所在位置。从这里开始。leagues.json所有公开联赛:id、名称、是否硬核、是否交易、开始与结束时间。ladder/<league>.json某联赛每个职业前 200 名英雄:排名、职业、升华、裂隙等级(Rupture Level)、最佳用时、主技能与辅助、实测守护者 DPS。builds/<hero>.json某英雄的完整构筑(每联赛每职业前 50 名):天赋节点、技能与辅助、宝石等级、每件装备的词缀与符文。meta/<league>.json职业、技能、辅助、升华、基石、显著天赋和传奇装备的使用占比。market/index.json与market/<league>/page-<n>.json只读的市场数据,见下面的市场一节。static/index.json然后是static/b<build>/game_data/*.json:每个补丁的技能、辅助、天赋树、装备底材、词缀、传奇、符文等。
每个文件都以 schema、generated_at(UTC)、game_build 和 patch 开头。英雄 id 是不透明的 16 位字符 id。
示例
const base = "https://clqwoilqnxutwsvdlrth.supabase.co/storage/v1/object/public/public-api/v1/";
const idx = await (await fetch(base + "index.json")).json();
const ladder = await (await fetch(base + "ladder/" + idx.leagues[0] + ".json")).json();
const top = ladder.heroes.find(h => h.has_build);
const build = await (await fetch(base + "builds/" + top.hero + ".json")).json();
console.log(top.class, top.rupture_level, build.build.items.length, "items");
市场(只读)
公开交易联赛中每一件正在出售的马车集市(Wagon Market)商品,都是纯文件,你想怎么搜索都行。里面没有任何买入、卖出或登录调用:只能看,不能交易。买卖仍然只在游戏里进行。
market/index.json各交易联赛及其商品数量,以及各联赛文件的位置。market/<league>/index.json总数、页数、价格区间、在线卖家数,以及按部位、稀有度、底材和传奇统计的数量(用它来做你的筛选框)。market/<league>/page-<n>.json每个文件 250 件商品,价格从低到高。每件商品包含物品底材、稀有度、传奇、物品等级、需求等级、词缀与数值、孔与符文、金币价格、上架与到期时间、卖家的英雄名,以及卖家码。
卖家码:卖家的好友码,例如 K7QM-4TZ2。买家在游戏的好友界面点“添加”并粘贴它,卖家接受后,双方就能私聊、申请加入对方,在游戏里当面交易。卖家可以在游戏里隐藏自己的卖家码,这样该商品只显示英雄名。请把卖家码连同复制按钮一起显示,不要把它当成可以在游戏外联系对方的方式。
const base = "https://clqwoilqnxutwsvdlrth.supabase.co/storage/v1/object/public/public-api/v1/market/";
const idx = await (await fetch(base + "index.json")).json();
const lg = idx.leagues[0];
const info = await (await fetch(base + lg.league + "/index.json")).json();
const pages = await Promise.all(info.files.map(f => fetch(base + lg.league + "/" + f).then(r => r.json())));
const all = pages.flatMap(p => p.listings);
const cheap = all.filter(l => l.rarity === "Unique" && l.price_gold < 5000);
console.log(cheap.length, "cheap uniques, first seller code:", cheap[0]?.seller_code);
每 5 分钟刷新一次,缓存 2 分钟。请最多每 5 分钟读取一次 market/index.json,然后只取你需要的文件。商品只是快照:可能在你看到之前就已售出,所以请在游戏里确认。隐藏的、被封禁的和机器人卖家不会出现,账号名和 Steam id 也不会出现。
刷新时间
- 天梯、构筑和 Meta:每小时一次,在每小时第 41 分钟后几分钟。
- 实测守护者数据:每 6 小时一次。
- 市场文件:每 5 分钟一次(见上)。
- 游戏数据:每个补丁一次。
- 文件缓存 10 分钟。请查看
index.json里的generated_at,只在它变化后再取。请不要每 10 分钟轮询超过一次。
合理使用与隐私
- 只用这些文件,不要碰游戏的服务器。不要抓取游戏、它的登录或游戏内天梯。
- 只包含官方公开联赛中的英雄。永远不含 Steam id、账号名、邮箱或 IP。机器人、被封禁账号和选择退出的玩家不包含在内。
- 请注明“数据:Broken Oath 公开 API”并附上游戏链接。不要把你的网站说成官方站点。
- 不要尝试把英雄 id 与真人对应起来。
- 游戏还在 alpha 阶段。数值、字段和 Meta 每个补丁都会变,请告诉你的用户。
版本
文件夹名 v1 只在出现破坏性改动时才会变,新的 v2 会与它并行至少 30 天。v1 随时可能新增字段,所以请忽略你不认识的字段。
做了工具?在 Discord 告诉我,每个帖子我都会看。