Notell API Docs
English

Админ-панель

Админ-панель

Админ-панель — веб-консоль для вашего бэк-офиса. Всё, что в ней можно сделать, доступно и через API там, где справочник API перечисляет метод; собственные endpoint-ы панели публичным API не являются. Страница перечисляет задачи, а не отдельные экраны, потому что внешний вид панели меняется.

Вход и роли#

Откройте панель по адресу https://notellgaming.com/admin/ и войдите с именем пользователя и паролем. Сессия длится 2 часа. Повторные неудачные входы ограничиваются (AUTH_THROTTLED): подождите минуту и повторите.

Есть две стороны, их определяет учётная запись:

Сторона платформыСторона клиента
КтоВладелец платформы и её персонал (owner, operator, viewer).Компания, интегрирующая платформу (client), и участники команды, которых она создаёт (client_user).
Кто создаётВладелец, в Staff.Только владелец платформы, в Clients. Самостоятельной регистрации нет.
Что видитВсе проекты.Только назначенные ему проекты. Каждый запрос проверяется на сервере; чужие данные отклоняются с 403 FORBIDDEN.

Что может учётная запись, определяют права:

ПравоРазрешает
game-historyИстория раундов.
api-logsПопытки колбэков кошелька.
launch-gameТестовый запуск игры.
freespins-view, freespins-grant, freespins-deleteПросмотр, выдача и отмена фриспинов.
configure-projectsИзменение настроек собственных проектов (URL колбэка, провайдеры, лимиты ставок) и управление целевыми исходами.
players-rtpИзменение RTP и лимитов ставок игрока (сторона клиента).
manage-credentialsAPI-ключ, URL колбэка, список IP и разрешённые источники фрейма (сторона клиента).
manage-usersСоздание участников команды (сторона клиента).

Владелец платформы (owner) может всё. Новый viewer получает game-history и api-logs; новый operator — все права платформы, кроме configure-projects. Давайте каждому минимально необходимый доступ.

Проекты, ключи и колбэк#

Откройте Projects, выберите проект, затем Integration. Кто что меняет: владелец, а также персонал или клиенты с configure-projects или manage-credentials в своих проектах. Остальные видят формы только для чтения.

  • API-ключ. Показан маской с отпечатком. Владелец может показать его целиком. Regenerate выпускает новый ключ, он показывается один раз; старый ключ перестаёт работать сразу. Revoke (сторона клиента) отзывает ключ без выпуска нового. Новый ключ скопируйте сразу. См. Аутентификацию.
  • URL колбэка. Базовый адрес вашего кошелька: https://, порт 443, публичный хост, без завершающего слэша. Используйте Test connection: он отправляет один запрос session_info и показывает HTTP-статус, задержку и ваш ответ. См. Колбэки кошелька.
  • Список IP. Сети (CIDR, IPv4 или IPv6), которым разрешено вызывать /gameActions.do и /playerRtp.do для проекта. Удаление всех адресов вашего сервера блокирует интеграцию. Запрос с другого адреса получает IP_NOT_ALLOWED. См. Аутентификацию.
  • Источники фрейма. Сайты, которым разрешено встраивать игру в iframe: до 16 источников https, без подстановочных знаков, путей и учётных данных (например, https://casino.example). Сайт, которого нет в списке, получает заблокированный фрейм. Сохранение вступает в силу примерно за 15 секунд. См. Встраивание.

Другие настройки проекта:

  • Enabled включает и выключает проект.
  • Валюта по умолчанию (любая из 157 поддерживаемых валют) и язык по умолчанию (ru, en или uk, используется, если в запуске нет lang; см. Языки).
  • Провайдеры: по Endorphina, Pragmatic Play и Nolimit City — переключатели игры, покупки бонуса, анте-ставки и гэмбла, где провайдер их поддерживает.
  • Bet management: таблица лимитов ставок проекта (Лимиты ставок). В каждой записи валюты обязательны и минимум, и максимум.
  • Pragmatic Play label: какие данные раунда (номер раунда, часы, время сессии, чистая позиция) игры Pragmatic Play показывают рядом с логотипом.

Настройки имеют ревизию: если коллега сохранил раньше, ваше сохранение отклоняется с PROJECT_SETTINGS_CONFLICT. Перезагрузите страницу и повторите изменение. Изменения лимитов, RTP и переключателей провайдеров действуют со следующего раунда; раунды в процессе завершаются как начались.

RTP и игроки#

Откройте RTP & players.

  • RTP проекта (60–100 %, по умолчанию 90 %), переключатель Personal RTP и адаптивное правило редактирует владелец платформы; остальные их читают. Изменения сохраняются автоматически. См. Управление RTP.
  • Игроки. Найдите игрока по id (или по никнейму игрока собственного сайта платформы), посмотрите его уровень, режим и журнал, задайте ручной уровень (60–100 %), верните его в auto или задайте личный лимит ставки. Менять игрока могут владельцы платформы и клиентские пользователи с players-rtp; лимиты игроков клиента должны оставаться в границах, которые для него настроил владелец. Ручной уровень действует, только пока включён Personal RTP.
  • Лимиты ставок по играм тоже задаются здесь (Лимиты ставок).

Те же действия с игроками доступны через API (/playerRtp.do).

Фриспины, целевые исходы и тестовый запуск#

  • Экран Free spins: выдача, просмотр и отмена выдач; список ставок содержит допустимые ставки игры, включая расширенные. Права freespins-*. См. Фриспины.
  • Экран Target outcomes: назначение и отмена записей (право configure-projects). Вместо id игрока можно ввести никнейм с сайта. См. Целевые исходы.
  • Launch game: открывает игру для тестового игрока в любой поддерживаемой валюте и языке (право launch-game).

Отчёты#

  • Dashboard, Analytics и Online: ставки, выплаты, GGR, RTP, спины и игроки по проектам, провайдерам, играм и валютам, а также игроки онлайн сейчас.
  • Game History (game-history): журнал раундов с фильтрами и операциями кошелька каждого раунда.
  • API Logs (api-logs): каждая попытка колбэка кошелька со временем, методом, статусом, задержкой и кодом ошибки; секреты скрыты. Начинайте с него, если запуск или ставка не проходят.

Те же данные доступны через API как report_rounds, report_ggr и report_reconciliation.

Персонал и роли#

Только владелец платформы. В Staff создаются и редактируются учётные записи платформы: имя пользователя, отображаемое имя, роль (operator, viewer или owner), пароль (не менее 8 символов), признак «включена», права и проекты, которые видит запись. Отключённая запись не может войти. Клиенты — не персонал; они создаются в Clients.

Отдельного экрана аудита в панели нет. Чувствительные действия (сохранение настроек проекта, показ или перевыпуск ключа, изменение URL колбэка или источников фрейма, выдача и отмена фриспинов, назначение целевых исходов) записываются в журнал аудита платформы с указанием учётной записи; за выгрузкой обратитесь к владельцу платформы. Изменения RTP игроков — в журнале игрока.

Кабинет клиента#

Владелец платформы в Clients: создаёт клиента с временным паролем (не менее 8 символов; клиент должен заменить его при первом входе), проектами, которые тот видит, правами, необязательными границами ставок по валютам и профилем. Отключение клиента блокирует всю его команду и завершает их сессии. Изменение проектов или прав клиента завершает его сессии и сужает его команду.

Клиент видит только экраны, которые разрешают его права, и только по своим проектам: Dashboard, Analytics, Game History, API Logs, Free spins, Target outcomes, RTP & players (только уровень и лимиты игроков), Projects (обзор, интеграция, управление ставками), список IP и My cabinet. Настройки только для платформы (правило RTP проекта, провайдеры, переключатели каталога, биллинг, персонал, клиенты) и показ уже существующего API-ключа клиентам недоступны.

В My cabinet клиент редактирует профиль компании и пароль, а с manage-users создаёт участников команды: участник получает подмножество проектов и прав самого клиента, но никогда не manage-users. Если платформа сужает область клиента, его участники теряют её тоже.

См. также#

Документация для операторов и интеграторов.Платформа TEST_ONLY: невыводимые единицы, реальные платежи не используются.