API агрегатора игр для казино: как он устроен

Как устроен API

Запросы с вашей стороны уходят на один эндпоинт в виде JSON в теле POST. Каждый содержит ваш логин, пароль и название нужного метода. Ответы приходят в JSON. Нет отдельных базовых URL под разные продукты и нет второй спецификации для live-казино или спорта: один iGaming API покрывает весь каталог из более чем 40 000 игр и sportsbook.

Трафик в обратную сторону, от нас к вам, — это seamless wallet: мы обращаемся к вашему серверу каждый раз, когда нужно прочитать или изменить баланс игрока. Эти коллбэки приходят как подписанные HTTP GET-запросы с query-параметрами.

Методы, которые вызываете вы

Список игр

Список игр — основа вашего лобби. У каждой позиции есть стабильный идентификатор, который вы сохраняете и передаёте обратно без изменений при запуске. Поле типа игры уже нормализовано по всем студиям, поэтому разделы «Слоты», «Live», «Crash», «Настольные» и «Спорт» можно собрать прямо из ответа. Live-столы и sportsbook — просто позиции в этом списке.

Запуск

Чтобы открыть игру, вы передаёте игрока, идентификатор игры, устройство (десктоп или мобильное) и страну игрока, а также, по желанию, язык. В ответ приходит URL, который нужно загрузить в iframe. Страна важна: некоторые студии исключают определённые рынки, и мы применяем эти ограничения по переданной вами стране, никогда не угадывая её по IP-адресу. Передавайте её при каждом запуске на реальные деньги.

Демо

Около 16 000 слотов можно запустить в демо-режиме по той же схеме. Запись игрока не нужна, коллбэки не срабатывают, поэтому демо-запуски безопасны на публичных страницах.

Коллбэки seamless wallet

Деньги игроков никогда не покидают вашу платформу. Мы отправляем на ваш callback URL три действия:

• balance: прочитать текущий баланс игрока, обычно при открытии сессии.
• debit: ставка. Спишите сумму и верните новый баланс либо верните код недостатка средств с текущим балансом.
• credit: выигрыш. Начислите сумму и верните новый баланс.

Каждый вызов содержит уникальный id транзакции, id раунда и идентификатор игры. Суммы — целые числа в минимальных единицах валюты. Ваш эндпоинт всегда отвечает HTTP 200; результат передаётся в теле JSON в виде кода ошибки: успех, недостаточно средств или ошибка обработки.

Откаты (rollback)

Откат — не отдельное действие. Он приходит как debit или credit с флагом rollback, и вы обрабатываете его как любое другое движение средств. Безопасность обеспечивает ваша дедупликация по id транзакции.

Безопасность

Каждый коллбэк содержит метку времени и ключ, вычисленный из этой метки и вашей секретной соли. Отклоняйте всё, что выходит за короткое временное окно или приходит с несовпадающим ключом. Для усиленной защиты каждый коллбэк также несёт заголовок HMAC-SHA256, рассчитанный по всем его параметрам, поэтому подменённая сумма или имя пользователя не пройдут проверку.

Фриспины и бесплатные раунды

Под этим названием скрываются две разные вещи, и здесь важна точность.

Внутриигровые фриспины работают по всему каталогу, и ничего строить не нужно. Фриспины от скаттеров, бонусные раунды, покупка бонуса и джекпоты работают внутри игры, а выигрыши приходят вам как обычные credit — часто без соответствующего debit. Ваш обработчик должен принимать такие начисления.

Промо-фриспины — те, что вы дарите игроку, например, в приветственном предложении, — с нашей стороны не выдаются через API в режиме самообслуживания. Если ваша бонусная схема строится на выдаче фриспинов, поговорите с нами до того, как начнёте её разрабатывать, и мы скажем, что можно организовать для нужных вам игр.

Валюты

Валюта задаётся для каждого игрока. Один аккаунт может обслуживать игроков во многих валютах, а сайт можно привязать к одной. Основная мультистудийная линейка слотов и sportsbook поддерживают 38 валют ISO, включая EUR, USD, GBP, CAD, AUD, BRL, MXN, ARS, INR, BDT, PKR, IDR, PHP, THB, VND, TRY, ZAR и ETB. Другие линейки добавляют или убирают валюты в зависимости от студии, поэтому ориентируйтесь на метод валют, а не на какой-либо буклет.

Sportsbook через тот же API

Sportsbook из нашего каталога, Nocturn Sport, запускается тем же вызовом, что и слот, и рассчитывается через те же три коллбэка. Прематч- и лайв-ставки списывают средства с игрока при размещении и начисляют при расчёте — для долгосрочных ставок это может произойти через часы или дни. Киберспорт — CS2, Dota 2 и Valorant — стоит рядом с футболом, теннисом и баскетболом. Наша доля с GGR спортивных ставок — 12%. Детали по спорту — на странице API ставок на спорт.

Мультибрендовые конфигурации

Операторам с несколькими сайтами не нужно интегрироваться дважды. Каждый дополнительный бренд получает свои ключи и callback URL в том же аккаунте, а каталог может отличаться от сайта к сайту, если этого требуют ваши лицензии.

Дальнейшие шаги

Следуйте пошаговому порядку на странице быстрая интеграция API казино, проверьте стоимость в разделе цены или запросите ключи на странице получения API-ключа. Если вы оцениваете несколько агрегаторов, в разделе сравнений показано, как каждый из них документирует свой кошелёк.