Открытый API
Я сделал его, чтобы вы могли делать сайты с рейтингом, оружейные и мета страницы для Broken Oath. Это набор обычных JSON файлов на CDN, который пересобирается раз в час. Без ключа и входа: вы просто скачиваете файлы. Только чтение, ничего нельзя записать.
Базовый адрес: https://clqwoilqnxutwsvdlrth.supabase.co/storage/v1/object/public/public-api/v1/
Точки доступа
index.jsonсхема, generated_at, сборка игры, патч, id лиг и место, где лежат данные игры этого патча. Начните отсюда.leagues.jsonвсе открытые лиги: id, название, хардкор, торговля, начало и конец.ladder/<league>.json200 лучших героев каждого класса одной лиги: место, класс, вознесение, уровень Разлома (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 символов.
Пример
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 минуты. Загружайте market/index.json не чаще раза в 5 минут, затем только нужные файлы. Лоты это снимок: лот могли купить до того, как вы его увидели, поэтому проверяйте в игре. Скрытые, забаненные и бот продавцы не попадают в файлы, как и имена аккаунтов и Steam id.
Время обновления
- Рейтинг, сборки и мета: раз в час, через несколько минут после 41 минуты.
- Измеренные числа по Стражу: каждые 6 часов.
- Файлы рынка: каждые 5 минут (см. выше).
- Данные игры: с каждым патчем.
- Файлы кэшируются на 10 минут. Смотрите
generated_atвindex.jsonи загружайте снова, только если он изменился. Пожалуйста, не опрашивайте чаще раза в 10 минут.
Честное использование и приватность
- Используйте файлы, а не серверы игры. Не парсите игру, её вход или рейтинг внутри игры.
- Только герои официальных открытых лиг. Никаких Steam id, имён аккаунтов, почты или IP. Боты, забаненные аккаунты и отказавшиеся игроки не включены.
- Укажите «Данные: открытый API Broken Oath» со ссылкой на игру. Не выдавайте свой сайт за официальный.
- Не пытайтесь связать id героя с реальным человеком.
- Это альфа. Числа, поля и мета меняются с каждым патчем. Пожалуйста, предупредите своих пользователей.
Версии
Имя папки v1 меняется только при ломающем изменении, а новая v2 работает рядом не меньше 30 дней. В v1 в любой момент могут появиться новые поля, поэтому игнорируйте незнакомые.
Сделали инструмент? Напишите мне в Discord, я читаю каждое сообщение.