Версионированный доступ к данным Manacost для Hearthstone-инструментов. Доступны каталог карт с токенами, статистика по форматам, рангам и периодам, история показателей, защищённые изображения, сервисные API-ключи и вход пользователя без передачи пароля приложению.
Доступно сейчас
Карты, токены, мета, Арена, Поля сражений, архетипы, сборки колод, история, анализ, изображения, ключи и вход приложения
Планируется
История конкретных сборок и отдельные матчи
Сервисный API-ключ
Передавайте выданный администратором ключ в заголовке X-API-Key. Этот вариант подходит серверным интеграциям и не представляет пользователя. Ключ показывается один раз и должен храниться как секрет.
curl "https://hearthpulse.net/api/v1/card-statistics?format=standard&rank=legend&period=1d&limit=120" \
-H "X-API-Key: mca_live_••••••••"Вход пользователя в трекере
Публичный desktop-клиент начинает Device Authorization Grant, открывает полученную ссылку в системном браузере и опрашивает token endpoint с указанным интервалом. Пароль остаётся только на сайте Manacost.
curl -X POST https://hearthpulse.net/api/v1/oauth/device/code \
-H "Content-Type: application/x-www-form-urlencoded" \
--data "client_id=manacost-tracker&scope=profile.read%20subscription.read%20catalog.read%20images.read%20statistics.read"Access token действует 15 минут, refresh token — до 30 дней и меняется при каждом обновлении. Refresh token храните в системном хранилище учётных данных и никогда не записывайте в логи.
Точки входа
/api/v1/catalog/manifestДоступные ресурсы и версия схемы
/api/v1/cardsСтандартный или вольный каталог, фильтры и курсорная пагинация
/api/v1/cards/{cardId}Данные карты, связанные токены и пулы генерации
/api/v1/card-statisticsПолный срез статистики Standard или Wild с пагинацией
/api/v1/cards/{cardId}/statisticsТекущие показатели карты для выбранного ранга и периода
/api/v1/cards/{cardId}/statistics/historyИстория показателей карты за 7–365 дней
/api/v1/meta-statisticsМета Standard или Wild по рангам, периодам и размеру выборки
/api/v1/archetypes/{slug}/statisticsТекущие агрегаты выбранного архетипа
/api/v1/archetypes/{slug}/statistics/historyИстория винрейта, популярности и темпа подъёма
/api/v1/archetypes/{slug}/analysisМатчапы по классам и влияние карт на результат
/api/v1/deck-statisticsПоказатели сборок, коды колод и канонические ссылки
/api/v1/decks/{deckId}/statisticsСтатистика, код и ссылки выбранной сборки
/api/v1/arena/statistics/classesВсе доступные показатели классов Арены и размеры выборок
/api/v1/arena/statistics/cardsПолная статистика карт Арены из HSReplay, Firestone и HearthArena
/api/v1/arena/statistics/legendariesПолная статистика легендарок, классов и связанных карт
/api/v1/arena/statistics/matchupsМатчапы классов Арены и доступные размеры выборок
/api/v1/battlegrounds/statistics/heroesГерои по режиму, MMR и периоду
/api/v1/battlegrounds/statistics/heroes/{heroId}Кривая таверны, сила героя, бои, композиции и финальные составы
/api/v1/battlegrounds/statistics/minionsВлияние, популярность и результаты существ
/api/v1/battlegrounds/statistics/minions/{dbfId}/historyВся сохранённая история статистики существа
/api/v1/battlegrounds/statistics/spellsПолная статистика заклинаний таверны
/api/v1/battlegrounds/statistics/tier-lists/{kind}Тир-листы героев, существ, заклинаний, аксессуаров и стратегий
/api/v1/cards/{cardId}/images/{variant}.webpКэшированные изображения thumb, full и tile
/api/v1/oauth/device/codeНачало безопасного входа desktop-приложения
/api/v1/oauth/tokenОбмен device code и ротация refresh token
/api/v1/meМинимальный профиль и права подписки
/api/v1/openapi.jsonМашиночитаемый контракт OpenAPI 3.1
Ошибки и совместимость
Клиент должен ориентироваться на поле error.code. Сообщение предназначено для человека и может уточняться без смены версии API. Все несовместимые изменения будут выпускаться в новом namespace.