Гид по интеграции · 2026
Запуск игры через API казино: сессии, токены, iframe и демо-режим
Открытие игры — тот единственный вызов API казино, который инициирует каждый игрок. Он определяет, какая игра загружается, в какой валюте и на каком языке, по какой лицензии, и создает сессию, к которой относятся все последующие вызовы кошелька. Сделайте все правильно — и игры открываются за секунду. Ошибетесь — получите пустые фреймы, неверные валюты и игры на рынках, где они не сертифицированы.
Коротко
- Запуск — это один подписанный запрос: игрок, токен сессии, игра, валюта, язык и юрисдикция. В ответ вы получаете URL.
- Загружайте этот URL в iframe в вебе или в webview в приложениях — и тестируйте оба варианта.
- Делайте токены короткоживущими и привязанными к одному игроку.
- Именно юрисдикция в запросе не пускает несертифицированные игры на рынок.
- Демо-режим не использует ни кошелек, ни игрока; держите его отдельно от игры на реальные деньги.
Что содержит запрос на запуск
В IGP через API казино вы открываете игру подписанным запросом с ID игрока, токеном сессии, ID игры, валютой, языком и юрисдикцией и получаете в ответ URL для загрузки в iframe или webview. У каждого поля своя задача:
| Поле | Почему это важно |
|---|---|
| ID игрока | Привязывает каждый вызов кошелька в сессии к одному аккаунту |
| Токен сессии | Подтверждает, что запуск пришел с вашей платформы, и начинает сессию |
| ID игры | Выбирает игру, а вместе с ней — сертифицированные версии студии |
| Валюта | Задает лимиты ставок и то, как выплачиваются выигрыши |
| Язык | Задает тексты в игре и экраны справки |
| Юрисдикция | Блокирует игры, не сертифицированные для рынка игрока |
Iframe или редирект
Iframe сохраняет на экране ваше лобби, шапку и баланс, пока идет игра, поэтому на десктопе это обычный выбор. На мобильных устройствах, особенно в приложениях, webview или полноэкранный режим часто удобнее. Тестируйте на реальных устройствах: поведение полноэкранного режима, смена ориентации и правила cookie различаются в разных браузерах, а некоторым играм для работы во фрейме нужны собственные настройки.
Сессии и токены
Ваша платформа выдает токен при запуске, а провайдер предъявляет его при первом вызове кошелька. Проверяйте его именно там: тот ли игрок, та ли игра, не истек ли срок, не использовался ли токен раньше. Дальше игру ведет сессия провайдера. Если игрок открывает одну и ту же игру в двух вкладках, решите, допустимо ли это, и протестируйте.
Детали безопасности токенов и подписей — в нашем руководстве по безопасности API казино.
Юрисдикция и сертификация
Для каждой игры в каталоге IGP указаны рынки, для которых она сертифицирована, и API проверяет это при запуске. Если юрисдикции из запроса нет в списке игры, игра не откроется. Именно это позволяет одному каталогу обслуживать несколько рынков, что важно по мере открытия новых, таких как Новая Зеландия.
Демо-режим
Демо- или фан-режим загружает игру на игровые деньги: без игрока, без кошелька, без реальной сессии. Он помогает игрокам выбирать, а вашей команде — тестировать лобби. Разделяйте в коде демо-запуски и запуски на реальные деньги и сначала проверяйте правила рынка: в Великобритании перед тем, как предлагать бесплатные версии азартных игр, требуется проверка возраста.
Что тестировать в первую очередь
- Запустите игры каждой категории (слоты, лайв, краш-игры) на десктопе и на мобильных устройствах.
- Запустите игру с истекшим и с повторно использованным токеном; ни в одном случае не должна открыться сессия на реальные деньги.
- Запустите игру с юрисдикцией, для которой она не сертифицирована; запуск должен быть отклонен.
- Смените валюту и язык и проверьте лимиты ставок и тексты.
- Откройте одну и ту же игру в двух вкладках и проверьте, что видит кошелек.
Частые вопросы
Запускайте 18 000+ игр одним запросом
150+ провайдеров через одну интеграцию — с проверкой сертифицированных рынков при запуске и песочницей для каждого теста выше.
