API — это интерфейс
API определяет, как одна система запрашивает у другой информацию или действие. Для платформы казино это может быть запрос каталога игр, открытие сессии или ответ на вызов кошелька. Контракт должен описывать авторизацию, идентификаторы, обязательные поля, ошибки и поведение при повторах.
API WGC — это интерфейс между серверами: ваш сервер вызывает его с ключом в заголовке X-API-Key, а каждый ответ приходит в одном и том же конверте с номером запроса и либо с данными, либо с ошибкой. Его описание открыто: это файл OpenAPI и страница документации.
Наличие API говорит о том, как общаться. Само по себе оно не говорит, до скольких студий вы сможете дотянуться и какой контент доступен вашему аккаунту. Это два вопроса, и при оценке их стоит задавать отдельно.
Агрегация — сервис за интерфейсом
Агрегатор собирает контент многих студий в общую модель подключения и работы. В его задачи может входить общий каталог, управление тем, какой аккаунт какие игры видит, структура аккаунтов для партнёров и клиентов, отчёты и сопровождение на время подключения. Точный объём у разных сервисов разный.
Поэтому не предполагайте, а спрашивайте, что входит. Слово «агрегатор» автоматически не покрывает аккаунты ваших игроков, платежи, риск-инструменты и все студии из публичного справочника. У WGC, например, справочник перечисляет 184 студии, но игры, выданные вашему аккаунту, определяет ваш менеджер.
Сравните работу, которая ляжет на команду
При отдельных подключениях к провайдерам ваши инженеры поддерживают отдельные контракты и различия между ними. При работе через агрегатор вы работаете с его общим контрактом для поддерживаемых сценариев, хотя поведение отдельных игр всё равно нужно проверять. Сравните эти пункты:
- Синхронизация каталога: как вы получаете сначала полный список, а затем изменения. WGC отдаёт 200 игр на страницу, а после первой загрузки вы запрашиваете только изменения с временем последней синхронизации.
- Идентификаторы игр: один номер для игры в вашем каталоге и один — для той же игры во всём каталоге.
- Параметры запуска: WGC нужны идентификатор игрока, валюта, режим и номер игры, а возвращает он ссылку для запуска.
- Сообщения кошелька: на какие вызовы вы отвечаете и как.
- Ответственность поддержки: кто помогает, когда что-то сломалось.
Небольшое первое подключение помогает только в том случае, если ваша команда потом может и разбирать ошибки. Поэтому сравнивайте не только день первого подключения, но и ежемесячную работу после запуска.
Название игры — не идентификатор
Похожих названий игр недостаточно, чтобы определить одну и ту же игру. Поэтому WGC даёт каждой игре стабильный publicId и universalId, одинаковый для одной и той же игры во всём каталоге. Названия нужны для показа, а идентификаторы — для сопоставления. Для списка запуска подтвердите игры, которые действительно доступны вашему аккаунту, и то, какие валюты и страны поддерживает каждая, а коммерческие условия проверяйте отдельно от бренда, который показывает лобби.
Вопросы для технического обсуждения
Задавайте эти вопросы любому агрегатору; ответы полезно получить письменно, чтобы потом проще было сравнивать.
- Ключи. Как обрабатываются отозванные учётные данные? В WGC вы сами создаёте и отзываете ключи в бэкофисе: до пяти боевых ключей и до двух тестовых.
- Пустая выдача. Что происходит, если аккаунту не выдано ни одной игры? В WGC ответ — успешный пустой список, а не ошибка.
- Изменения каталога. Как отдаются изменения? WGC возвращает только изменения после времени вашей последней синхронизации и рекомендует полную синхронизацию не реже раза в сутки.
- Безопасные повторы. Какие операции можно безопасно повторять? Ключ идемпотентности, действующий 24 часа, возвращает тот же ответ на тот же запрос сессии, а повторное открытие той же игры тем же игроком возвращает ту же сессию, пока она открыта.
- Ошибки. Можно ли получить пример ошибки со ссылкой для поддержки? Каждый ответ несёт номер запроса.
- Кошелёк. До реального трафика согласуйте идентификатор транзакции, обработку дублей, таймауты и сверку. В WGC ставка записывается один раз на идентификатор транзакции, а на ваш ответ WGC ждёт три секунды.
Как это применяется в WGC
World Gaming Connect объединяет B2B-бэкофис с доступом к каталогу, открытием сессий и Callback-кошельком. Для операционного управления есть дерево аккаунтов с правами команды и коммерческий баланс в USD. Поддержка — часть картины: Ask WGC отвечает по документации, а живая поддержка работает внутри бэкофиса.
Следующий шаг — согласовать с командой объём контента и план проверок; тестовый ключ открывает тестовую игру без денег. Готовность каждого проекта подтверждается отдельно, поэтому статья не означает, что каждая перечисленная студия или сценарий готовы для вашего проекта. Технические подробности — в обзоре Casino API, а сам сервис — на странице игрового агрегатора, в справочнике провайдеров и в шагах интеграции.