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

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",
  "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
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

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)

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

HTML

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