Что такое API казино
API — это определённый способ, которым одна система просит у другой информацию или действие. API казино применяет эту идею к работе онлайн-казино: ваша платформа запрашивает игры и открывает их, а сторона контента спрашивает у вашей платформы о балансах и ставках. Контракт называет запросы, поля, ответы и ошибки, так что две команды могут строить решение на его основе, не созваниваясь каждый день. Иными словами, API казино — это письменная договорённость о том, что одна сторона может попросить у другой и в каком виде получит ответ.
API WGC — это интерфейс «сервер—сервер». Ваш сервер вызывает его с ключом в заголовке X-API-Key, и каждый ответ приходит в одном и том же конверте: признак ok, идентификатор запроса и либо данные, либо ошибка. Ваш код должен ветвиться только по коду ошибки, потому что сообщение написано для людей. Браузеры API не вызывают, а кросс-доменные вызовы не поддерживаются, так что ключ остаётся на вашем сервере.
Четыре задачи API казино
1. Каталог. Ваша платформа запрашивает игры, выданные её аккаунту, по 200 на страницу. У каждой игры есть постоянный publicId, который определяет игру в вашем каталоге, и universalId, одинаковый для одной и той же игры во всём каталоге. У неё также есть название, тип, адреса картинок и признаки демо, фриспинов и других возможностей. После первой полной загрузки вы передаёте время последней синхронизации и получаете только изменения, а игры, которые нужно снять, помечаются признаком.
2. Открытие игры. Когда игрок выбирает игру в вашем лобби, ваш сервер просит API открыть её. Запрос несёт идентификатор игрока, валюту, режим (реальный или демо) и номер игры. Ответ — ссылка запуска, которую открывает браузер игрока, при желании внутри фрейма. Неоткрытая ссылка работает пять минут, а открытая — пока игрок активен.
3. Кошелёк. Во время игры игре нужен баланс, и она должна записывать ставки и выигрыши. В модели seamless-кошелька деньги игрока остаются на вашей платформе, поэтому API обращается к вам: WGC отправляет подписанные запросы на ваш Callback URL с тремя командами — прочитать баланс, записать ставку вместе с выигрышем и отменить ставку. Этому посвящена страница seamless-кошелька.
4. Запросы статуса. Потом ваша платформа может узнать, что стало с операцией, раундом или сессией, используя собственные номера, то есть те номера, под которыми их видела ваша платформа. У операции бывает статус «принята», «отклонена», «сбой» или «неизвестна», а раунд сообщает ставку, выигрыш и разницу.
Два направления вызовов
Полезно представить, что вызовы идут в обе стороны. В первом направлении ваш сервер обращается к WGC: читает каталог, открывает игры и запрашивает статусы. Во втором направлении WGC обращается к вашей платформе: читает балансы и записывает ставки, выигрыши и отмены. Оба направления входят в один контракт, а интеграция считается законченной только тогда, когда работают оба. Поэтому проверять нужно сразу оба направления, а не только запросы к каталогу.
Второе направление несёт более строгие правила, потому что двигает деньги. Каждый вызов подписан HMAC-SHA256 секретом вашего аккаунта, а ваш обработчик должен проверять подпись по сырому телу до его разбора. WGC ждёт ваш ответ три секунды. Ставка записывается один раз на идентификатор транзакции, так что повторный вызов не списывает с игрока дважды и не меняет возвращаемый баланс.
Как проходит раунд
Вот путь одной игры шаг за шагом; те же шаги повторяются для каждого игрока и каждой игры.
- Ваша платформа синхронизировала каталог и показывает игры в лобби.
- Игрок выбирает игру, и ваш сервер просит её открыть.
- WGC возвращает ссылку запуска, и браузер игрока её открывает.
- Игра запрашивает баланс. WGC обращается к вашему Callback URL, вы отвечаете, и игра начинается.
- На каждую ставку WGC снова обращается к вам со ставкой и, как правило, в том же вызове — с выигрышем.
- Если ваш ответ не пришёл вовремя, ставка отклоняется студии, операция получает статус «неизвестно», а позже WGC просит вас отменить её откатом (rollback).
- После раунда ваша платформа может запросить операцию, раунд или сессию по своим собственным номерам.
Что делает API казино удобным для проверки
Техническая команда должна иметь возможность оценить API до того, как свяжет себя с ним. У WGC описание API публично: файл OpenAPI и страница документации, оба открываются без ключа. Если они расходятся, прав файл. API не ломается без предупреждения: могут появляться новые поля, поэтому незнакомые вы игнорируете, а поле удаляется только после пометки об устаревании и не раньше чем через 90 суток.
Ограничения тоже записаны. По умолчанию ключ может открывать 600 игр в минуту, а запросы каталога и статуса допускаются в количестве 120 в минуту. Менеджер может поднять лимиты аккаунта по запросу.
Для проверки не нужны настоящие деньги, а описание API можно читать ещё до получения доступа. Тестовый ключ открывает тестовую игру WGC Test Slot, которая делает настоящие вызовы на ваш Callback URL. В бэкофисе проверка интеграции показывает живой журнал каждого вызова, а тест интеграции выполняет 14 проверок вашего кошелька. Примеры обработчиков, скрипт самопроверки и чек-лист запуска публичны. Подробнее — на странице интеграции и в разделе демо и тестовый режим.
Чем API казино не является
API казино — это не казино для игроков. WGC не ведёт казино, не хранит балансы игроков и не регистрирует игроков: ваша платформа хранит собственных игроков и их деньги. Доступ в клиентскую зону выдаёт лично менеджер, самостоятельной регистрации нет. API казино также не обещание результата игры: выбранный RTP — это настройка, переданная студии, и не каждая игра её принимает.
Полный список запросов и то, как они сочетаются, смотрите в обзоре Casino API.