Возможности

Демо-режим

Демо-режим открывает любую игру как бесплатную демо-игру для посетителя, который не вошёл на вашем сайте. Игра, её математика и оригинальный клиент те же, что и в сессии с кошельком; виртуальны только деньги. Используйте его для кнопок «Играть бесплатно» и превью.

Без кошелька. Демо-сессия никогда не вызывает колбэки вашего кошелька (session_info, bet, win, round_info) и ничего не пишет в ваши отчёты, итоги и GGR. Её раунды принадлежат внутреннему демо-проекту, который не входит ни в один отчёт.
Изолированный демо-кошелёк. Баланс — отдельные игровые деньги в валюте сессии, по умолчанию 100 000.00. Демо-кошельки разных проектов никогда не смешиваются.
Тот же метод запуска. Демо-режим — это POST /playGame.do с gametype: "fun". Режим с кошельком — gametype: "demo" (значение называется demo по историческим причинам); см. Запуск игры.
То же поведение. Ставки, выигрыши, фриспины внутри игры, покупки бонуса и анте-ставки работают как обычно.
Недоступно в демо. Фриспины оператора, целевые исходы и персональный RTP применяются только в сессиях с кошельком. Устаревшее поле запуска freespins отклоняется.

Запуск демо-игры#

POST/playGame.dogametypefun

Создаёт демо-сессию и возвращает ссылку на клиент игры. Запрос — это запрос запуска с gametype: "fun" и демо-полями ниже.

Запрос#

curl

curl -s -X POST https://notell-api.com/playGame.do \
  -H 'Content-Type: application/json' \
  -d '{
    "provider": "own",
    "partner": "demo-casino",
    "api_key": "YOUR_API_KEY",
    "symbol": "gates-of-olympus",
    "currency": "EUR",
    "gametype": "fun",
    "player_id": "player-1024",
    "demo_balance": "5000.00",
    "demo_reset": true,
    "lang": "en"
  }'

JSON

{
  "provider": "own",
  "partner": "demo-casino",
  "api_key": "YOUR_API_KEY",
  "symbol": "gates-of-olympus",
  "currency": "EUR",
  "gametype": "fun",
  "player_id": "player-1024",
  "demo_balance": "5000.00",
  "demo_reset": true,
  "lang": "en"
}

Поле	Тип	Обязательно	Описание
`provider`, `partner`, `api_key`, `symbol`, `currency`, `lang`, `client_platform`, `region`			Как в Запуске игры.
`gametype`	enum	да	`"fun"` для демо-режима.
`player_id`	string	нет	1–128 символов. Только задаёт демо-кошелёк (см. ниже); в ваш кошелёк не передаётся.
`demo_balance`	money	нет	Стартовый демо-баланс JSON-числом или десятичной строкой с не более чем 2 знаками, от 1.00 до 10 000 000.00. По умолчанию: 100000.00.
`demo_reset`	boolean	нет	Пополнить демо-кошелёк до `demo_balance` при этом запуске. Имеет смысл с `player_id`. Любой другой тип — `INVALID_REQUEST`.

demo_balance и demo_reset принимаются только с gametype: "fun"; с gametype: "demo" они дают INVALID_REQUEST.

Ответ#

json

{
  "status": "ok",
  "link": "https://notell-api.com/… (game client address with the session token)",
  "meta": {
    "session_id": "9d0c3f7e-2b1a-4c58-a6d3-7e4f1b0c9a28",
    "currency": "EUR",
    "language": "en",
    "gametype": "fun"
  }
}

Поле	Тип	Описание
`link`	string	URL, который нужно открыть в браузере игрока. Содержит токен сессии.
`meta.session_id`	string	Id демо-сессии.
`meta.currency`, `meta.language`	string	Валюта и код языка сессии.
`meta.gametype`	string	`"fun"` для демо-сессии.

В meta есть и информационные поля о сборке игры; незнакомые игнорируйте.

Ошибки#

Код	HTTP	Когда
`INVALID_DEMO_BALANCE`	400	`demo_balance` вне 1.00–10 000 000.00, не число и не числовая строка либо более двух знаков после запятой.
`INVALID_REQUEST`	400	`demo_reset` — не boolean, `player_id` — не 1–128 символов либо `demo_balance` / `demo_reset` переданы с `gametype: "demo"`.
`DEMO_UNAVAILABLE`	503	Демо-режим не подготовлен на сервере.

Остальные ошибки запуска (UNAUTHORIZED, UNSUPPORTED_GAME и др.) такие же, как у любого запуска.

Как ведёт себя демо-кошелёк#

Без player_id каждый запуск получает новый кошелёк со свежим балансом. Повтор с тем же Idempotency-Key возвращает ту же сессию.
С player_id демо-кошелёк сохраняется для этого id (по проекту и валюте) между запусками и играми: баланс переносится. demo_reset: true пополняет его до demo_balance, а баланс ниже 1.00 пополняется автоматически, чтобы посетитель не застрял на нуле.
Перезагрузка. Перезагрузка игры или повторный запуск при незавершённом раунде продолжает этот раунд; баланс восстанавливается из демо-кошелька.

См. также#

Запуск игры: полный запрос запуска.
Основные понятия: сессии и раунды.