給工具作者
公開 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 告訴我,每個帖子我都會看。