Краткий ответ
Самая сложная терминологическая проблема в проекте Slots API редко состоит в том, что кто-то не знает термин. Она возникает, когда разные команды используют один термин для разных объектов. Например, «доступно» может означать, что игра указана в каталоге, подключена в staging, включена в production или проверена для целевого рынка. Стабильные определения позволяют сохранять вопросы закупки, проектирование интерфейса, тестовые доказательства и производственные решения в рамках одной области фактов.
Эта страница дает краткие определения, которые можно использовать по всему сайту. Для полных методов выбора, приемки, надежности и проверки рынка следуйте тематическим руководствам, а не рассматривайте глоссарий как учебник по реализации.
Основные роли и понятия каталога
| Термин | Краткое определение | Чего он не устанавливает |
|---|---|---|
| Провайдер / игровой провайдер | Сторона, поставляющая игровой контент, игровые сервисы или связанные интерфейсы. | Что AG обладает правами на распространение или что контент доступен на конкретном рынке. |
| Агрегатор | Интеграционный слой, который нормализует или координирует доступ между платформой и несколькими провайдерами. | Что исчезают различия провайдеров, коммерческие условия, сертификация или проверка рынка. |
| Платформа | Бизнес-система, управляющая учетными записями игроков, кошельками, операционной деятельностью или пользовательским интерфейсом. | Что она является провайдером, RGS или юридически ответственным оператором в конкретной юрисдикции. |
| Оператор / операционная организация | Организация, ответственная за операции в пределах указанной области проекта или рынка; ее точное значение зависит от договора и юрисдикции. | Что подключение API предоставляет операционную авторизацию. |
| RGS / Remote Game Server | Компонент системы, который размещает или координирует удаленную работу игры, состояние и связанные транзакционные взаимодействия. | Что он является агрегатором или что системы с похожими названиями имеют одинаковую область сертификации. |
| Каталог / каталог игр | Набор записей игр с информацией о происхождении, идентичности, версии, статусе и проверке. | Что включение в каталог означает инвентарь в реальном времени, включение в production или допуск на рынок. |
| ID записи каталога | Внутренний идентификатор, последовательно отслеживающий одну запись каталога. | Что он заменяет код игры провайдера или ID транзакции. |
| Код игры провайдера | Код, используемый провайдером или вышестоящим интерфейсом для уникальной идентификации игры. | Что его можно вывести из отображаемого названия или слага страницы. |
| Версия игры | Идентифицируемая версия игрового программного обеспечения или сборки контента. | Что она совпадает с версией математической модели. |
| Версия математической модели | Версия математической модели, определяющей вероятности, выигрыши и теоретические статистические характеристики. | Что неизменный интерфейс означает отсутствие изменений модели. |
Сессии, раунды и транзакции
| Термин | Краткое определение | Чего он не устанавливает |
|---|---|---|
| Запуск | Процесс, при котором платформа запрашивает и открывает указанную игру с согласованными параметрами. | Что получение результата запуска завершает игровой поток или проверку целевого рынка. |
| URL запуска | URL входа в игру или адрес с токеном, созданный для конкретного контекста запуска. | Что это постоянная публичная ссылка или что ее можно раскрывать и повторно использовать вне согласованной области. |
| Игровая сессия | Ограниченный контекст взаимодействия для идентифицированного пользователя, игры и среды после входа в игру. | Что это учетная запись игрока, сессия входа, кошелек или один раунд. |
| Раунд | Бизнес-единица, объединяющая одно или несколько событий ставок и результатов согласно правилам игры. | Что один раунд всегда соответствует одной транзакции. |
| Транзакция | Аудируемая бизнес-запись, изменяющая баланс или бизнес-состояние. | Что успех API означает, что каждая система достигла окончательной согласованности. |
| Ставка | Тип транзакции, запрашивающий или подтверждающий списание ставки в указанном раунде. | Что клиентская анимация доказывает успешное списание. |
| Выигрыш | Тип транзакции, увеличивающий баланс или создающий подлежащую выплате сумму из подтвержденного результата. | Какой-либо результат в другом раунде или долгосрочную отдачу игроку. |
| Возврат | Основанный на правилах возврат всего или части эффекта существующей транзакции. | Что удаление исходной транзакции является приемлемой реализацией. |
| Откат / сторнирование | Прослеживаемая операция, компенсирующая существующий бизнес-эффект. | Что произвольный запрос на возврат можно повторно воспроизвести; он должен ссылаться на исходный объект и сохранять идемпотентность. |
| Баланс | Денежное состояние, используемое для бизнес-решения по указанному счету, валюте и моменту времени. | Что одно чтение доказывает сверку всех асинхронных записей. |
| Валюта | Денежная единица и правила точности, используемые для отображения, ставок, расчетов или отчетности. | Что техническая поддержка валюты устанавливает разрешение для целевого рынка. |
Понятия кошелька и надежности
| Термин | Краткое определение | Чего он не устанавливает |
|---|---|---|
| Единый кошелек | Модель, в которой платформа управляет балансом игрока, а игровые транзакции взаимодействуют с кошельком платформы через API реального времени. | Что исчезают тайм-ауты, дубликаты, неизвестные состояния и требования к сверке. |
| Переводной кошелек | Модель, в которой средства перемещаются между кошельками со стороны платформы и игры и записываются отдельно. | Что два баланса по своей природе согласованы в реальном времени. |
| Callback | Взаимодействие сервер-сервер, при котором одна сторона уведомляет согласованный адрес о событии или запрашивает обработку бизнеса. | Порядок прибытия, уникальность или доставку ровно один раз, если это не предусмотрено протоколом. |
| Идемпотентность | Свойство, при котором повторная обработка одного бизнес-запроса не создает дублирующий бизнес-эффект. | Простое возвращение того же ответа; система должна распознать одно намерение и сохранить соответствующий результат. |
| Ключ идемпотентности | Стабильный ключ для идентификации одного и того же бизнес-запроса. | Что ключ можно генерировать заново для каждого повтора или использовать без области вечно. |
| Повтор | Еще одна попытка при ограниченных условиях, числе попыток и политике задержки, если завершение не установлено. | Что тайм-аут равен сбою; небезопасный повтор может создать дублирующий эффект. |
| Неизвестное состояние | Состояние, в котором вызывающая сторона не может по текущему ответу определить, завершилось ли бизнес-действие. | Что система может немедленно зафиксировать успех или сбой; она должна выполнить запрос, безопасно повторить при явной семантике или провести сверку. |
| ID корреляции | Идентификатор трассировки, связывающий запросы, callback, журналы и записи между системами. | Что он заменяет ID бизнес-транзакции или ключ идемпотентности. |
| Сверка | Процесс сравнения независимых записей транзакций, раундов или балансов для выявления и устранения расхождений. | Идемпотентность в реальном времени, поиск состояния или контроль исключений. |
| Окончательное состояние | Бизнес-состояние, которое протокол определяет как больше не изменяющееся в обычном процессе. | Что HTTP-ответ об успехе сам по себе является окончательным бизнес-состоянием. |
Среды, версии и рыночные доказательства
| Термин | Краткое определение | Чего он не устанавливает |
|---|---|---|
| Staging | Непроизводственная среда и конфигурация, используемые для интеграции, проверки и приемки. | Что прохождение staging означает развертывание production или проверку реального бизнес-поведения. |
| Production | Среда, обрабатывающая авторизованный живой трафик и данные. | Что production URL или учетные данные означают одобрение каждой игры, рынка и версии. |
| Версия API | Идентифицируемая версия контрактов интерфейса, полей и поведения. | Что версия игры или математической модели та же самая. |
| Версия интеграции | Версионированная запись выбранной топологии и конфигурации между платформой, агрегатором, RGS и провайдером. | Что старые доказательства продолжают применяться после изменения критически важного компонента. |
| RTP / Return to Player | Теоретическая средняя отдача на большом числе событий при определенных правилах игры и указанной математической модели. | Результат одного события, короткого периода или отдельного игрока. |
| RNG / Random Number Generator | Компонент или механизм, поставляющий случайные значения для игровых результатов или связанных случайных процессов. | Что его реализация, версия или сертификация были проверены лишь потому, что упоминается RNG. |
| Сертификация / доказательства соответствия | Доказательства тестирования или соответствия, выданные указанным органом для определенного объекта, версии, требований и области. | Всемирную лицензию или автоматический охват операционной организации, бренда, домена или новой версии. |
| Сертификация интеграции | Доказательства соответствия для указанной комбинации и области взаимодействия, включающей такие компоненты, как платформа, RGS, агрегатор и провайдер. | Все прочие проверки, необходимые для отдельной игры или операционной организации. |
| Тестирующий орган | Организация, проводящая тестирование или выдающая отчеты в пределах определенной области признания. | Что все услуги и отчеты этого органа входят в признание регулятора. |
| Стандарт | Спецификация, описывающая технические требования, требования к тестированию или контролю. | Что применение лабораторного стандарта, такого как GLI-19, автоматически дает допуск в юрисдикцию. |
| Доступность на рынке | Статус с определенной областью, формируемый из целевого рынка, операционной организации, игры и версии, сертификации, валюты, языка, прав и решения проекта. | Вывод, который может быть установлен только включением в каталог, языком, валютой или подключением API. |
| Поддержка языка | Проверенная возможность работы с языком для определенной области интерфейса, правил, справки или коммуникации. | Полный перевод, действительную сертификацию или доступность на рынке. |
Примечание о непроверенной области для
RTP 0–1000Этот числовой диапазон не является определением RTP в глоссарии. Для него по-прежнему нужны определения единицы и смысла, версии математической модели, разрешений на доступ, материалов тестирования и сертификации, целевого рынка и представления. Его нельзя толковать как проверенное заявление о производительности, возврате или соответствии рынку.
Распространенные неоднозначности, которые нужно устранить
| Неоднозначное утверждение | Факты, которые необходимо разделить |
|---|---|
| «Игра есть в каталоге, значит, она доступна». | Внесено в каталог, проверено в staging, включено в production, коммерчески доступно и проверено для целевого рынка |
| «У запроса тайм-аут, значит, он завершился ошибкой». | Неизвестный транспортный результат, неизвестное бизнес-состояние, подтвержденный сбой, безопасный повтор и требование сверки |
| «Один раунд равен одной транзакции». | Раунд — бизнес-единица игры; ставка, выигрыш, возврат и откат могут быть отдельными транзакциями |
| «Поддерживаются BRL и португальский, значит, Бразилия готова». | Валюта, язык, версия игры, топология интеграции, сертификация, операционная организация, бренд или домен и рыночные правила |
| «Есть сертификация, значит, это работает во всем мире». | Признание тестирующего органа, стандарт, протестированный объект, версия, юрисдикция, действительность и условия проекта |
Что в настоящее время можно оценить на этом сайте
- Публичная справка API использует понятия, включая каталог, запуск, единый кошелек, переводной кошелек, записи и процесс интеграции.
- Руководства по надежности объясняют, почему дублирующие запросы, тайм-ауты, сбои callback, неизвестные состояния и сверка должны входить в одно решение.
- Этот глоссарий создает краткие определения для использования по всему сайту, не добавляя эндпоинты, методы подписания, учетные данные или факты производственного протокола.
- Каталог содержит 11 провайдеров и 1 194 названия игр. Это снимок на уровне названий, а не вывод о поставке в реальном времени, включении в production, правах на контент, версиях, сертификации или доступности на целевом рынке.
Границы, о которых следует помнить
- Не обещаются конкретное поле API, производственный протокол, реализация кошелька, уровень производительности, SLA или дата релиза.
- Не обещается, что какая-либо игра, провайдер, сертификат, язык или валюта сейчас доступны на целевом рынке.
- Эти общие определения не заменяют договор, спецификацию интерфейса, регуляторное правило или одобрение проекта.
- Бизнес-выражение
RTP 0–1000сохранено как термин с ограниченной областью, но не представляет проверенное числовое определение, универсальную возможность, результат игрока или факт допуска на рынок.
Часто задаваемые вопросы
Являются ли провайдер и агрегатор одним типом компании?
Это разные роли. Провайдер прежде всего поставляет игровой контент или сервисы; агрегатор координирует доступ между несколькими провайдерами и платформой. Одна компания может выполнять несколько ролей, но записи проекта все равно должны разделять ее фактическую ответственность.
Должны ли callback, транзакция и раунд использовать один ID?
Обычно их не следует сводить к одному идентификатору. Callback — механизм взаимодействия, транзакция — изменение бизнес-состояния, а раунд — бизнес-единица игры. Каждому нужна стабильная идентичность, а ID корреляции связывают их согласно контракту интерфейса.
Означает ли RTP, что игрок получает этот процент каждый раз?
Нет. RTP — теоретическая долгосрочная статистическая мера при указанных правилах и математической модели. Она не гарантирует результат одного события или краткосрочный исход. Для любого числового значения также нужны версия игры и математической модели, доказательства тестирования и область представления.
Связанные материалы и следующие шаги
Первые семь руководств охватывают полные вопросы, стоящие за этими определениями:
- Что такое много-провайдерный Slots API? — объекты и границы, соединяемые агрегацией.
- API агрегатора и прямая интеграция с провайдером — компромиссы между маршрутами интеграции.
- Как оценить провайдера Slots API — доказательства для закупки и вопросы комплексной проверки.
- От staging к production — доказательства для производственного решения.
- Идемпотентность, повторы и сверка — обработка сбоев, дубликатов и неизвестных состояний.
- Управление данными каталога игр — поля, состояния жизненного цикла, версии и ответственность.
- Матрица рынка, игры, версии и сертификации — проверка целевого рынка по объекту и области.
Основные страницы: публичная справка API, каталог игр и процесс интеграции.
При использовании раздела «Связаться с нами» опишите этими терминами целевой рынок, область каталога, модель кошелька, среду и версии. Затем AG сможет подтвердить терминологию и область доказательств до обсуждения проекта. Это не является обязательством по поставке, сертификации или production.
Источники и область применения
- Главная страница AG Game
- Публичная документация API
- Каталог игр и область подсчета
- UK Gambling Commission RTS 3: rules, game descriptions and likelihood of winning
- Brazil Ministry of Finance SPA: Technical FAQ
- Gaming Laboratories International: Standards
Регуляторные источники и стандарты используются для объяснения терминологии. Они не доказывают, что проект выполнил упомянутые требования. Для конкретного проекта подтвердите, что каждое определение соответствует текущему интерфейсу, договору и правилам целевого рынка.
Нужно превратить это руководство в план проекта?
Материал помогает оценить проект, но не заменяет техническое, договорное, сертификационное или правовое подтверждение.