/arena/targets/refresh

Перегенерировать список целей. Первые попытки бесплатны, дальше — по растущей цене, сначала за софт, затем за хард.

Параметры

Нет.

Результат

{
    "response": {
        "success": 1,
        "refreshes_used": 3,
        "season_id": 27,
        "count": 5,
        "items": ["...targets"],
        "self": {"...ranking entry"},
        "valid_until": 1788527400
    }
}

Что важно знать

До завершения онбординга метод отказывает кодом 10061 (ArenaNotOnboarded) — до любых списаний. Игрок, не победивший Цукера, в боях не участвует (онбординг). Это страховка: состояние клиент знает заранее из onboarding.onboarded в /arena/info.

Бесплатных обновлений target_free_refresh за сутки (см. config в /arena/info), дальше — платно.

Цену следующего обновления НЕ надо считать самому — сервер отдаёт её в next_refresh ответа /arena/targets. Цена задаётся листом arenaRefreshCosts по номеру платного обновления, и дубль обхода этой таблицы на клиенте гарантированно разъехался бы с сервером. Оттуда же берётся валюта: ТЗ требует «сначала софта, затем харда».

Суточный лимит — target_refresh_limit. Исчерпан — метод отказывает (Refresh limit reached). Ноль в конфиге означает «без лимита», а не «нельзя обновлять»: лимит заводит геймдизайн, и до появления числа механика работает.

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

Гранулярность суточная. ТЗ пишет «лимит обновлений на каждый бой», но и бесплатные, и лимит считаются за сутки (решение заказчика 04.09.2026). Сам список при этом пересобирается после каждой собственной атаки игрока (см. /arena/targets), и счётчик обновлений эта пересборка не трогает.

Если софт-валюты не хватает — метод отказывает (10403), а не обновляет список бесплатно. Отдельный случай: валюты может не быть в версии конфига сессии — это тоже отказ, а не бесплатное обновление.

Списание идёт через штатный конвейер кошелька — с контекстом аналитики (arena_refresh) и записью в историю операций.