Создание кампании фриспинов

Общая информация

Тип запроса	URL
POST	<server-pixmove-games>/freespins/create

Метод позволяет создать фриспин кампанию. По параметрам созданной кампании будут выдаваться фриспины игрокам.

Как это работает

В реализации фриспинов используются две основные сущности - кампания фриспинов и фриспины. В рамках одной кампании фриспинов пользователю могут быть начислены только одни фриспины.

Кампания фриспинов - это общая промоакция, которую может создать партнер и по параметрам которой игрокам будут присвоены бесплатные вращения (фриспины).

Фриспины - это бесплатные вращения, которые будут начисляться игрокам при заходе в игру.

При заходе в игру система проверяет подходит ли игрок под параметры кампании фриспинов (нужная валюта/нужная игра/нужный игрок). Если проверка пройдена успешно, то игроку будут начислены фриспины.

Параметры

Запрос

Если в запросе создания кампании фриспинов не указывать параметры currencies/gameIds/playerIds - то фриспины будут выдаваться всем игрокам.

Пример: если в запросе на создание кампании указать только gameIds = [1], то фриспины будут выдаваться всем игрокам, на любых валютах, которые зайдут в игру с id = 1.

Значение параметра strictBetLevel:

• true гарантирует, что игроку будут выданы фриспины по указанному betLevel; Если в игре отсутствует такой же betLevel - игроку будут недоступны фриспины.
• при false (по умолчанию), в случае отсутствия нужного betLevel в игре, будет использован ближайший.

Название	Тип		Описание
campaignExtId	string		Уникальный идентификатор кампании фриспинов в системе клиента
spinCount	bigint		Количество фриспинов
partnerId	bigint		Уникальный идентификатор партнера
betLevel	bigint		Размер желаемой ставки (из размеров ставок)
strictBetLevel	boolean	optional	Включение обязательного совпадения размера ставки для фриспинов (по умолчанию - false )
betLevelCurrency	string	optional	Валюта ставки (по умолчанию "USD")
startTime	string		Время начала кампании фриспинов в формате ISO 8601
endTime	string		Время окончания кампании фриспинов в формате ISO 8601
hash	string		Подпись (sha256 от hash строки)
maxWin	string	optional	Максимальная выигрышная сумма в валюте betLevelCurrency (по умолчанию - не ограничена)
minWin	string	optional	Минимальная выигрышная сумма в валюте betLevelCurrency (по умолчанию - "0")
currencies	array	optional	Валюты для которых будут выдаваться фриспины
gameIds	array	optional	Идентификаторы игр для которых будут выдаваться фриспины
playerIds	array	optional	Идентификаторы игроков для которых будут выдаваться фриспины

Hash строка

“freespins_create” + campaignExtId + spinCount + partnerId + betLevel + apiKey

Ответ

Название	Тип	Описание
id	bigint	Уникальный идентификатор кампании фриспинов

Пример

Запрос

{  
    campaignExtId: 1,
    spinCount: 20,
    betLevel: 8,
    betLevelCurrency: 'USD',
    strictBetLevel: true,
    maxWin: '10000000',
    minWin: '200',
    partnerId: 1,
    startTime: '2025-07-01T15:04:32.384Z',
    endTime: '2025-07-07T15:04:32.384Z',
    currencies: ['RUB', 'USD', 'EUR'],
    playerIds: ['1', '2', '3'],
    gameIds: [1, 2, 3, 4, 5],
    hash: '123' 
}

Ответ

{
    "status": "success",
    "data": {
        "id": 713
    },
    "serverTime": 1748437219129,
    "duration": 334
}