/batch/call

Метод для пакетного вызова одного и того же API-метода в рамках одного запроса. В текущей реализации поддерживает только bounty/get.

Адрес метода

/batch/call

Требует сессию пользователя

Параметры

Параметр Обязательный Тип Описание
method ДА string Название метода для пакетного вызова. Сейчас поддерживается bounty/get и /bounty/get.
items ДА json[] JSON-список объектов параметров для выбранного метода. Должен содержать от 1 до 20 элементов.

Формат items для bounty/get

Параметр Обязательный Тип Описание
bounty_id ДА any Цифровой или строковый идентификатор награды
member_id НЕТ int Идентификатор пользователя, за которого нужно получить награду

Пример запроса

{
    "method": "bounty/get",
    "items": [
        {
            "bounty_id": "referral_reach_1",
            "member_id": 123
        },
        {
            "bounty_id": "referral_progress_3",
            "member_id": 123
        }
    ]
}

Результат

Метод возвращает общий response.success и обновление update.member с актуальными секциями игрока для выбранного batch-метода. Для текущего bounty/get это обновленные wallet и bounty.

{
    "response": {
        "success": 1,
        "timestamp": 1775512800.123456
    },
    "update": {
        "member": {
            ...,
            "wallet": [
                {...currency},
                {...currency}
            ],
            "bounty": [
                {...bounty},
                {...bounty}
            ]
        }
    },
    "events": [
        {
            "type": "reward",
            "payload": {
                "reasonType": "referral",
                "reasonId": "batch",
                "sources": ["referral_reach_1", "referral_progress_3"],
                "rewards": [
                    { "type": "soft", "amount": 300 }
                ]
            }
        }
    ]
}

events

Для batch-вызова bounty/get метод возвращает один агрегированный reward event.

Поле Тип Описание
reasonType string referral, если все баунти пакета из рефералки (amountRewards, progressRewards и selfRewards листа referrals), иначе bounty_claim
reasonId string batch
sources array Источники награды в формате массива строковых идентификаторов. Смысл идентификаторов зависит от reasonType и reasonId
rewards array Суммарные выданные награды в формате { type, amount }

Если хотя бы один элемент items невалиден, весь пакет завершается ошибкой и изменения не применяются.

Пустой items, JSON-объект вместо списка или список больше 20 элементов завершается ошибкой Invalid items count (zero or greater than max).