Интеграция API казино для игровых платформ

API казино WGC — это интерфейс «сервер—сервер» для операторов. Через него ваша платформа получает каталог игр, выданных её аккаунту, открывает игры игрокам, отвечает на вызовы кошелька и читает статус собственных операций. Эта страница кратко описывает, как он устроен; шаги до запуска в работу — на странице интеграции. Ниже вы увидите сначала аутентификацию, а затем игры, кошелёк и ограничения.

Один конверт, один ключ

Ваш сервер вызывает API с ключом в заголовке X-API-Key. Каждый ответ использует один и тот же конверт с признаком ok, идентификатором запроса и либо данными, либо ошибкой. Ветвите код только по коду ошибки; сообщение написано для людей. API не рассчитан на браузеры и не поддерживает кросс-доменные вызовы, то есть ваш ключ никогда не попадает в браузер, а вызовы делает только ваш сервер.

Ключи вы создаёте и отзываете сами в бэкофисе: до пяти боевых и до двух тестовых, значение показывается один раз. Новый боевой ключ в аккаунте с реальным трафиком начинает отвечать через 30 минут или сразу после подтверждения вторым человеком.

Что работает

Работают следующие методы: проверка здоровья, не требующая ключа, каталог игр, открытие сессии, три запроса статуса по вашим собственным номерам (операция, раунд и сессия), запрос сессий по вашему собственному идентификатору сессии, лимиты выигрыша и вызовы кошелька, которые WGC делает к вашей платформе. Машинное описание — файл OpenAPI 3.1, открытый без ключа, а описание для людей — публичная страница документации. Если они расходятся, прав файл; поэтому при написании интеграции за деталями обращайтесь к файлу.

Игры и сессии

Запрос игр возвращает игры, выданные вашему аккаунту, по 200 на страницу; у каждой есть publicId, universalId, тип, адрес картинки и признаки возможностей. После первой полной загрузки вы запрашиваете только изменения, передавая время последней синхронизации. Подробности каталога — в обзоре агрегатора игр и на странице API слотов.

Запросу сессии нужны идентификатор игрока, валюта, режим (реальный или демо) и один номер игры. Можно добавить язык, адрес возврата, платформу, страну игрока, ваш собственный идентификатор сессии и, для игр, которые это принимают, RTP от 75 до 96 и границы ставок. Ключ идемпотентности, действующий 24 часа, возвращает тот же ответ на тот же запрос, а повторное открытие для того же игрока и той же игры возвращает ту же сессию, пока она открыта.

Кошелёк и запросы статуса

Балансы игроков остаются на вашей платформе; иными словами, деньги игрока храните вы, а не WGC. WGC обращается к вашему Callback URL с подписанными запросами на баланс, на ставку с выигрышем и на откат; контракт описан в разделе интеграция seamless-кошелька. Затем вы можете прочитать статус операции, раунда или сессии по своим номерам. Журнал ваших запросов к API хранится 90 суток.

Фриспины

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

Лимиты выигрыша и RTP

Лимиты выигрыша можно читать и менять через API при наличии соответствующего права, а в бэкофисе вы ставите линии остановки подозрительных выигрышей: один выигрыш, выигрыши игрока за час и выигрыши аккаунта за час, внутри границ платформы. RTP и границы ставок на запуск задаются в запросе или в бэкофисе для игр, которые их поддерживают.

Ограничения и стабильность

По умолчанию ключ может открывать 600 игр в минуту, а запросы каталога и статуса допускаются в количестве 120 в минуту. Всплески с одного адреса ограничены, а превышение получает ответ о превышении частоты с временем ожидания. Менеджер может поднять лимиты аккаунта; вы можете попросить об этом для своего. По запросу вызовы вашего аккаунта можно ограничить списком адресов — до 50 записей.

Версия API не ломается без предупреждения. Могут появляться новые поля, поэтому игнорируйте незнакомые. Поле удаляется или меняет смысл только после пометки об устаревании и не раньше чем через 90 суток. Несовместимое изменение стало бы новой версией, а текущая продолжала бы работать рядом.

Сначала попробуйте

Тестовый ключ открывает тестовую игру, которая делает настоящие вызовы на ваш Callback URL без денег, так что весь путь можно пройти до запуска в работу. См. демо и тестовый режим, валюты — для правил валют, и шаги интеграции.

Вопросы и ответы

Есть ли публичное описание API?

Да: файл OpenAPI 3.1 и страница документации, оба открываются без ключа.

Можно ли вызывать API из браузера?

Нет. Это API «сервер—сервер».

Как получить ключ?

Вы создаёте его сами в бэкофисе, который открывает вам менеджер.

Готовы подключаться? Обсудить подключение.

Следующее подключение
начинается здесь.

Расскажите, что вы создаёте. Начнём с этого.

Связаться