Справочник

Справочник API

Базовый URL: https://notell-api.com. Указатель ниже перечисляет каждый endpoint, метод /gameActions.do и колбэк кошелька; каждая запись ведёт на страницу с параметрами, примерами и ошибками.

Документ OpenAPI на английском языке. Скачать openapi.json

Эндпоинты оператора

Метод	Назначение
POST`/playGame.do`	Открыть игру игроку: возвращает ссылку на сессию (режим с кошельком или бесплатное демо).
POST`/playerRtp.do`action`get`	Прочитать состояние персонального RTP игрока.
POST`/playerRtp.do`action`set`	Задать персональный RTP игрока (60–100 %).
POST`/playerRtp.do`action`auto`	Вернуть игрока на автоматическое управление RTP.
POST`/playerRtp.do`action`bet-limit`	Задать или снять лимит ставок игрока.

Методы POST /gameActions.do

Метод	Назначение
POST`/gameActions.do`method`freespins_create`	Выдать игроку фриспины в одной игре.
POST`/gameActions.do`method`freespins_get`	Получить одну выдачу фриспинов по `grant_id` или `external_id`.
POST`/gameActions.do`method`freespins_list`	Список выдач проекта с фильтрами (сначала новые, до 200).
POST`/gameActions.do`method`freespins_cancel`	Отменить неиспользованные спины активной выдачи.
POST`/gameActions.do`method`outcome_schedule`	Запланировать целевой исход: выигрыш заданного множителя на n-м платном спине игрока.
POST`/gameActions.do`method`outcome_get`	Получить один целевой исход по `outcome_id` или `external_id`.
POST`/gameActions.do`method`outcome_list`	Список целевых исходов с фильтрами (до 200).
POST`/gameActions.do`method`outcome_cancel`	Отменить целевой исход, который ещё не применён.
POST`/gameActions.do`method`round_cancel`	Отменить незавершённый раунд и вернуть списанную ставку.
POST`/gameActions.do`method`report_rounds`	История раундов со ставкой, выигрышем и возвратом по каждому (постранично).
POST`/gameActions.do`method`report_ggr`	GGR (ставки − возвраты − выигрыши) по дням, играм и валютам.
POST`/gameActions.do`method`report_reconciliation`	Итоги по кошельку на игрока и валюту для сверки с вашим учётом.

Колбэки кошелька (платформа вызывает ваш сервер)

Метод	Назначение
CALLBACK`session_info`	Прочитать баланс игрока при запуске игры.
CALLBACK`bet`	Списать ставку перед платным раундом; отказ — `INSUFFICIENT_FUNDS`.
CALLBACK`win`	Зачислить выигрыш; для фриспинов — одно итоговое зачисление на выдачу.
CALLBACK`refund`	Вернуть списание (неподтверждённая ставка или отмена оператором).
CALLBACK`round_info`	Уведомление о начале или конце раунда (только для учёта).
CALLBACK`freespins_finished`	Итог завершённой выдачи фриспинов (после итогового зачисления).

Публичные эндпоинты только для чтения

Метод	Назначение
GET`/games/catalog`	Каталог игр: изображение, категория, RTP, волатильность, возможности, максимальный выигрыш.
GET`/games/health`	Опубликованные игры с языками запуска и возможностями для оператора.
GET`/capabilities`	Список возможностей для казино: валюты, игры, IP колбэков, лимиты запросов.
GET`/health`	Проверка работоспособности (база данных доступна).