Интеграция с серверной частью

Game API введение

примечание

Партнер - сторона, интегрирующая игры.

Провайдер - сторона, предоставляющая игры (Aviatrix).

В данном разделе описаны методы, которые уже реализованы на стороне провайдера. Они вызываются партнером для запуска игры и для получения информации по прошедшему игровому раунду.

Game API методы

к сведению

Все POST запросы содержат HTTP заголовок X-Auth-Signature, необходимый для подтверждения подлинности хоста. Эта операция позволяет отказаться от IP whitelist при интеграции, так как последний лишает возможности провайдера оперативно масштабироваться (горизонтально), не предупреждая при этом бренд.

подсказка

Базовый url можно получить по запросу у интеграционного менеджера.

/game/url

Метод используется для генерации URL-адреса для запуска игры с заданными параметрами.

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

Внимание

Заголовки запроса, указанные в примере, обязательны: Accept, Content-Type, X-Auth-Signature

POST /game/url HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "productId": "nft-aviatrix",
  "sessionToken": "5fc0cbd8-6328-43a5-a016-c075950d5393",
  "lang": "en",
  "country": "EN",
  "lobbyUrl": "https://example.com",
  "isDemo": false,
  "promoCode": "ABCD2025",
  "hideExitButton": false
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор может быть одинаковым для всех сред в рамках бренда
productId	идентификатор игры	string	обязательный	примеры идентификаторов: `nft-aviatrix`, `second-chance`, `aviatrix-fruits`. С полным списком можно ознакомиться на странице всех продуктов
sessionToken	токен игровой сессии	string	обязательный при isDemo=false	токен должен быть сгенерирован брендом для дальнейших запросов от серверной части провайдера. Ожидаемая длина: 1-255 символов. Не требуется для демо режима
lang	код языка	string	опциональный	формат кода ISO 639-1. Значение по умолчанию `en`
country	код страны	string	опциональный	формат кода ISO-3166-1 alpha-2. Пример: `US`, `EN`, `DE`
lobbyUrl	URL лобби	string	опциональный	необходим для перенаправлений на главную страницу бренда
isDemo	флаг демо режима	bool	обязательный для демо режима	необходим для включения демо режима игры. Обязательный параметр для демо режима
promoCode	промокод	string	опциональный	нужен для прямого открытия формы ввода промокода. Если значение передано (promoCode=promocode1&…), произойдет открытие модального окна и заполнение инпута. Если параметр пустой (promoCode=&…), откроется форма ввода с пустым значением инпута.
hideExitButton	позволяет управлять видимостью кнопки выхода в меню	bool	опциональный	позволяет управлять видимостью кнопки выхода в меню, переопределяя её отображение, если оно включено в конфигурации

Пример ответа от сервера

HTTP/1.1 200 OK
{
  "url": "https://domain.com?cid=somebrand&productId=nft-aviatrix&sessionToken=qwerty12345&lang=en&lobbyUrl=https://example.com"
}

Параметр	Описание	Тип	Пояснение
url	URL запуска игры	string	полный URL для запуска игры с параметрами

/game/list

Метод используется для отображения списка доступных для бренда игр.

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

Внимание

Заголовки запроса, указанные в примере, обязательны: Accept, Content-Type, X-Auth-Signature

POST /game/list HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform"
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	идентификатор может быть одинаковым для всех сред в рамках бренда

Пример ответа от сервера

HTTP/1.1 200 OK
{
  "games": [
    {
      "productId": "nft-aviatrix",
      "name": "Aviatrix",
      "rtp": "97.00"
    }
  ]
}

Параметр	Описание	Тип	Пояснение
games	список игр	array	в списке отображаются только игры доступные для указанного бренда
productId	идентификатор игры	string	примеры идентификаторов: `nft-aviatrix`, `second-chance`, `aviatrix-fruits`. С полным списком можно ознакомиться на странице всех продуктов
name	наименование игры	string	доступные языки: `en`
rtp	процент возвратов игрокам	string	высчитывается в долгосрочной перспективе

/game/round

Предоставление информации о результатах раунда или конкретной ставки пользователя.
По умолчанию используется формат ответа application/json, для получения HTML страницы необходимо передать HTTP заголовок ACCEPT со значением text/html

Пример запроса для любой игры

Внимание

Заголовки запроса, указанные в примере, обязательны: Accept, Content-Type, X-Auth-Signature

POST /game/round HTTP/1.1
Content-Type: application/json
Accept: application/json
X-Auth-Signature: <signature>

{
  "cid": "someplatform",
  "playerId": "john",
  "productId": "nft-aviatrix",
  "roundId": "2028207"
}

Параметр	Описание	Тип	Требования	Пояснение
cid	уникальный идентификатор платформы	string	обязательный	значение из URL параметров провайдера игр при интеграции
playerId	идентификатор пользователя	string	обязательный	значение из запроса /playerInfo
productId	идентификатор игры в рамках платформы	string	обязательный	примеры идентификаторов: `nft-aviatrix`, `second-chance`, `aviatrix-fruits`. С полным списком можно ознакомиться на странице всех продуктов
roundId	идентификатор матча (раунда игры)	string	обязательный при отсутствии betId	значение из запроса /bet
betId	идентификатор ставки	string	обязательный при отсутствии roundId	значение из запроса /bet

Примеры ответов от сервера для Aviatrix

HTML

Game Round

JSON

HTTP/1.1 200 OK

{
  "roundId": "3838216",
  "roundOdd": 4.19,
  "finishedAt": "2024-10-18T08:38:02Z",
  "bets": [
    {
      "id": "af5ec231-42dd-4c3d-5eaf-ebe859da69da",
      "currency": "EUR",
      "betAmount": 100,
      "winAmount": 140,
      "odds": 1.40
    },
    {
      "id": "c4d3312c-69da-475c-af5e-be8e59dadd42",
      "currency": "EUR",
      "betAmount": 100,
      "winAmount": 152,
      "odds": 1.52
    }
  ]
}

Детали параметров

Параметр	Описание	Тип	Пояснение
roundId	идентификатор матча (раунда игры)	string	значение из запроса /game/round
roundOdds	коэффициент завершения матча (раунда игры)	double	коэффициент, с которым завершился раунд
finishedAt	время завершения матча (раунда игры)	timestamp	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
bets	ставки пользователя	array	все или указанная в betId ставка пользователя
bet.id	идентификатор ставки	string	id ставки
bet.currency	валюта ставки	string	ISO-4217-3 format. валюта, в которой пользователь сделал ставку
bet.odds	коэффициент выигрыша	double	коэффициент, на котором игрок забрал выигрыш. odds = 0, если игрок проиграл
bet.betAmount	сумма ставки	integer	сумма ставки пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
bet.winAmount	сумма выигрыша	integer	сумма выигрыша пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)

Примеры ответов от сервера для Second Chance

HTML

Second CHance Game Round

JSON

HTTP/1.1 200 OK

{
  "roundId": "353383",
  "finishedAt": "2026-06-25T12:38:23Z",
  "bets": [
    {
      "id": "eb96f787-f389-4eff-bd95-96607e67a2a7",
      "currency": "EUR",
      "betAmount": 500,
      "winAmount": 605,
      "odds": 1.21
    }
  ],
  "roundOdds1": 1.14,
  "roundOdds2": 5.67
}

Параметр	Описание	Тип	Пояснение
roundId	идентификатор матча (раунда игры)	string	значение из запроса /game/round
roundOdds1	коэффициент первого краша	double	коэффициент при котором раунд завершился для части игроков
roundOdds2	коэффициент второго краша	double	коэффициент при котором раунд завершился для оставшихся игроков
finishedAt	время завершения матча (раунда игры)	timestamp	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
bets	ставки пользователя	array	все или указанная в betId ставка пользователя
bet.id	идентификатор ставки	string	id ставки
bet.currency	валюта ставки	string	ISO-4217-3 format. валюта, в которой пользователь сделал ставку
bet.odds	коэффициент выигрыша	double	коэффициент, на котором игрок забрал выигрыш. odds = 0, если игрок проиграл
bet.betAmount	сумма ставки	integer	сумма ставки пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
bet.winAmount	сумма выигрыша	integer	сумма выигрыша пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)

Примеры ответов от сервера для Aviatrix Fruits

HTML

Slots Game Round

JSON

HTTP/1.1 200 OK

{
  "roundId": "699252",
  "finishedAt": "2026-05-08T12:18:10Z",
  "bets": [
    {
      "id": "8a36e6cd-882d-4595-82c2-d9ed77e15a6e",
      "currency": "EUR",
      "betAmount": 1000,
      "winAmount": 5000,
      "odds": 5
    }
  ],
  "reels": [
    [
      "c",
      "c",
      "c",
      "g",
      "f"
    ],
    [
      "f",
      "c",
      "d",
      "e",
      "g"
    ],
    [
      "f",
      "d",
      "d",
      "g",
      "f"
    ]
  ],
  "winLines": [
    {
      "line": 1,
      "symbol": "C",
      "count": 3,
      "winAmount": 5000
    }
  ]
}

Детали параметров

Параметр	Описание	Тип	Пояснение
roundId	идентификатор матча (раунда игры)	string	значение из запроса /game/round
finishedAt	время завершения матча (раунда игры)	timestamp	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
bets	ставки пользователя	array	все или указанная в betId ставка пользователя
bet.id	идентификатор ставки	string	id ставки
bet.currency	валюта ставки	string	ISO-4217-3 format. валюта, в которой пользователь сделал ставку
bet.odds	коэффициент выигрыша	double	коэффициент, на котором игрок забрал выигрыш. odds = 0, если игрок проиграл
bet.betAmount	сумма ставки	integer	сумма ставки пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
bet.winAmount	сумма выигрыша	integer	сумма выигрыша пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
reels	финальная комбинация	array	размер: 5 барабанов по 3 символа
winLines	выигрышные линии	array	пустой список в случае проигрыша
winLines.line	номер выигрышной линии	integer	порядковый номер
winLines.symbol	символ выигрышной линии	string	текущие идентификаторы: `SC`, `A`, `B`, `C`, `D`, `E`, `F`, `G`
winLines.count	количество символов данной линии	integer	значения в диапазоне: `3-5`
winLines.winAmount	сумма выигрыша данной линии	integer	валюта выигрыша указана в bet.currency

Примеры ответов от сервера для Aviatrix Mines

HTML

Mines Game Round

JSON

HTTP/1.1 200 OK

{
  "roundId": "1328",
  "finishedAt": "2026-07-08T09:47:13Z",
  "bets": [
    {
      "id": "639498c8-59e6-4b91-b339-9e8ef765ba8d",
      "currency": "EUR",
      "betAmount": 31500,
      "winAmount": 39375,
      "odds": 1.25
    }
  ],
  "openedCells": [
    21,
    7
  ],
  "minePositions": [
    9,
    12,
    19
  ]
}

Детали параметров

Параметр	Описание	Тип	Пояснение
roundId	идентификатор матча (раунда игры)	string	значение из запроса /game/round
finishedAt	время завершения матча (раунда игры)	timestamp	format: yyyy-MM-dd’T’HH:mm:ss.SSSZ
bets	ставки пользователя	array	все или указанная в betId ставка пользователя
bet.id	идентификатор ставки	string	id ставки
bet.currency	валюта ставки	string	ISO-4217-3 format. валюта, в которой пользователь сделал ставку
bet.odds	коэффициент выигрыша	double	коэффициент, на котором игрок забрал выигрыш. odds = 0, если игрок проиграл
bet.betAmount	сумма ставки	integer	сумма ставки пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
bet.winAmount	сумма выигрыша	integer	сумма выигрыша пользователя в формате minor currency unit (учитывая центы, т.е. число умноженное на 100)
openedCells	открытые игроком плитки	array of integers	индекс плитки в диапазоне 0-24 (первый ряд 0-4, второй ряд 5-9, и т.д. до 20-24)
minePositions	позиция плиток с минами	array of integers	индекс плитки в диапазоне 0-24 (первый ряд 0-4, второй ряд 5-9, и т.д. до 20-24)

Game API введение​

Game API методы​

/game/url​

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

Пример ответа от сервера​

/game/list​

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

Пример ответа от сервера​

/game/round​

Пример запроса для любой игры​

Примеры ответов от сервера для Aviatrix​

HTML​

JSON​

Детали параметров​

Примеры ответов от сервера для Second Chance​

HTML​

JSON​

Примеры ответов от сервера для Aviatrix Fruits​

HTML​

JSON​

Детали параметров​

Примеры ответов от сервера для Aviatrix Mines​

HTML​

JSON​

Детали параметров​

Game API введение

Game API методы

/game/url

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

Пример ответа от сервера

/game/list

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

Пример ответа от сервера

/game/round

Пример запроса для любой игры

Примеры ответов от сервера для Aviatrix

HTML

JSON

Детали параметров

Примеры ответов от сервера для Second Chance

HTML

JSON

Примеры ответов от сервера для Aviatrix Fruits

HTML

JSON

Детали параметров

Примеры ответов от сервера для Aviatrix Mines

HTML

JSON

Детали параметров