API — это интерфейс

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

API WGC — это интерфейс между серверами: ваш сервер вызывает его с ключом в заголовке X-API-Key, а каждый ответ приходит в одном и том же конверте с номером запроса и либо с данными, либо с ошибкой. Его описание открыто: это файл OpenAPI и страница документации.

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

Агрегация — сервис за интерфейсом

Агрегатор собирает контент многих студий в общую модель подключения и работы. В его задачи может входить общий каталог, управление тем, какой аккаунт какие игры видит, структура аккаунтов для партнёров и клиентов, отчёты и сопровождение на время подключения. Точный объём у разных сервисов разный.

Поэтому не предполагайте, а спрашивайте, что входит. Слово «агрегатор» автоматически не покрывает аккаунты ваших игроков, платежи, риск-инструменты и все студии из публичного справочника. У WGC, например, справочник перечисляет 184 студии, но игры, выданные вашему аккаунту, определяет ваш менеджер.

Сравните работу, которая ляжет на команду

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

  • Синхронизация каталога: как вы получаете сначала полный список, а затем изменения. WGC отдаёт 200 игр на страницу, а после первой загрузки вы запрашиваете только изменения с временем последней синхронизации.
  • Идентификаторы игр: один номер для игры в вашем каталоге и один — для той же игры во всём каталоге.
  • Параметры запуска: WGC нужны идентификатор игрока, валюта, режим и номер игры, а возвращает он ссылку для запуска.
  • Сообщения кошелька: на какие вызовы вы отвечаете и как.
  • Ответственность поддержки: кто помогает, когда что-то сломалось.

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

Название игры — не идентификатор

Похожих названий игр недостаточно, чтобы определить одну и ту же игру. Поэтому WGC даёт каждой игре стабильный publicId и universalId, одинаковый для одной и той же игры во всём каталоге. Названия нужны для показа, а идентификаторы — для сопоставления. Для списка запуска подтвердите игры, которые действительно доступны вашему аккаунту, и то, какие валюты и страны поддерживает каждая, а коммерческие условия проверяйте отдельно от бренда, который показывает лобби.

Вопросы для технического обсуждения

Задавайте эти вопросы любому агрегатору; ответы полезно получить письменно, чтобы потом проще было сравнивать.

  1. Ключи. Как обрабатываются отозванные учётные данные? В WGC вы сами создаёте и отзываете ключи в бэкофисе: до пяти боевых ключей и до двух тестовых.
  2. Пустая выдача. Что происходит, если аккаунту не выдано ни одной игры? В WGC ответ — успешный пустой список, а не ошибка.
  3. Изменения каталога. Как отдаются изменения? WGC возвращает только изменения после времени вашей последней синхронизации и рекомендует полную синхронизацию не реже раза в сутки.
  4. Безопасные повторы. Какие операции можно безопасно повторять? Ключ идемпотентности, действующий 24 часа, возвращает тот же ответ на тот же запрос сессии, а повторное открытие той же игры тем же игроком возвращает ту же сессию, пока она открыта.
  5. Ошибки. Можно ли получить пример ошибки со ссылкой для поддержки? Каждый ответ несёт номер запроса.
  6. Кошелёк. До реального трафика согласуйте идентификатор транзакции, обработку дублей, таймауты и сверку. В WGC ставка записывается один раз на идентификатор транзакции, а на ваш ответ WGC ждёт три секунды.

Как это применяется в WGC

World Gaming Connect объединяет B2B-бэкофис с доступом к каталогу, открытием сессий и Callback-кошельком. Для операционного управления есть дерево аккаунтов с правами команды и коммерческий баланс в USD. Поддержка — часть картины: Ask WGC отвечает по документации, а живая поддержка работает внутри бэкофиса.

Следующий шаг — согласовать с командой объём контента и план проверок; тестовый ключ открывает тестовую игру без денег. Готовность каждого проекта подтверждается отдельно, поэтому статья не означает, что каждая перечисленная студия или сценарий готовы для вашего проекта. Технические подробности — в обзоре Casino API, а сам сервис — на странице игрового агрегатора, в справочнике провайдеров и в шагах интеграции.