/battle/report-stats

Метод принимает отчет о завершенном бое и двигает счетчики objectives, которые известны только из боя.

Обработка идемпотентна по battleId: клиент повторяет отправку отчета при сбое сети, поэтому повторный отчет с тем же battleId не двигает счетчики, но возвращает актуальное состояние.

battleId должен совпадать с серверной боевой сессией — отчёт с неизвестным или просроченным (дольше 6 часов) battleId отклоняется с ошибкой по параметру battleId. Режим боя (gameMode) определяется сервером по найденной сессии, а не берётся из отчёта — значение gameMode в теле запроса игнорируется.

Подходят два вида сессий:

• уровень — battleId, который вернул /level/start или /level/continue (32 hex-символа). Режим — campaign или dungeon, по самому уровню;
• арена — числовой battle_id, который вернул /arena/fight/start (или /arena/fight/rebattle). Режим — arena (gameMode = 2). Учитывается только строка атаки самого игрока: зеркальная строка защиты боем не является и отчёта не порождает.

Оба вида сессий выдаются сервером и оплачены игроком (энергией — уровень, попыткой или билетом — арена), поэтому исключений «режим из отчёта» здесь нет и быть не может: battleReported() двигает все общие счётчики (враги, гемы, комбо, урон), так что любая лазейка по gameMode открыла бы фарм всех счётчиков разом.

Счетчики, которые сервер знает сам (battles_played, battles_lost, levels_completed, campaign_levels_completed, dungeon_levels_completed, campaign_max_level_reached, dungeon_max_level_reached), из отчета не берутся — они приходят из /level/complete, где режим и результат серверные. Иначе бой посчитался бы дважды.

Аренные счётчики (arena_battles_played, arena_wins, arena_losses, arena_max_ap, arena_league_reached) из отчёта тоже не берутся: отчёт существует только у боя, доигранного до конца, а сдача и брошенный бой на арене — это тоже поражения, которые нужно посчитать. Они приходят из ArenaManager::applyResult() — единственной точки, через которую проходит любая завершённая атака.

Параметры

Тело запроса повторяет клиентский DTO BattleStatsReport. Поля, которых нет в таблице ниже, игнорируются.

Счетчики

Накопительные: enemies_defeated, gems_matched_<color>, combos_activated, <cat|dog|pepe>_bonuses_activated, gem_damage_dealt, skill_damage_dealt, damage_received, health_restored, <poison|fire|bleed>_damage_dealt, debuffs_removed_from_self, buffs_removed_from_enemy. При победе — battle_won_no_damage_taken (damageTaken = 0), battle_won_no_skills (skillsUsage.totalActivations = 0), battle_won_1_hp (minHeroHpDuringBattle = 1), battle_won_low_hp (minHeroHpDuringBattle < 10).

Счетчики-максимумы: combo_max_length, max_damage_in_single_hit, max_simultaneous_buffs_on_self, max_simultaneous_debuffs_on_enemy, max_unique_color_skills_in_battle, max_unique_faction_skills_in_battle.

Числовые значения отчета ограничены сверху разумным пределом: заведомо невозможное значение урезается до предела с записью в лог, а не отклоняет отчет целиком — иначе одно поле стоило бы игроку всех счетчиков за бой.

Результат

{
    "response": {
        "questsDirty": true,
        "achievementsDirty": false,
        "unclaimedQuestsCount": 1,
        "unclaimedAchievementsCount": 0,
        "dailyChestProgress": {
            "points": 20,
            "claimableChestsCount": 0
        },
        "pendingCompletions": [
            {
                "id": "quest_6a71ba248ee7b2.78729389",
                "type": "quest",
                "templateId": "dq_combos_10",
                "tierIndex": 0,
                "occurredAt": 1786010916
            }
        ]
    },
    "update": {
        "member": {
            "wallet": [],
            "options": {}
        }
    }
}

При повторном отчете с тем же battleId оба флага dirty будут false.