Интеграция

Каталог и возможности

Три публичных метода только для чтения описывают, что доступно. Им не нужны partner и api_key.

Метод	Назначение
`GET /games/health`	Опубликованные игры со всеми языками игры и признаками `free_spins` / `target_outcomes`
`GET /capabilities`	Стабильный контракт казино: игры с провайдером, названием, валютами, режимами и тремя языками казино
`GET /health`	Проверка работоспособности
`GET /docs/openapi.json`	Это API в виде документа OpenAPI 3.1 (см. справочник API)

`GET /games/health`#

bash

curl -s https://notell-api.com/games/health

json

{
  "status": "ok",
  "games": [
    {
      "game_id": "gates-of-olympus",
      "languages": ["en", "ru", "uk"],
      "free_spins": true,
      "target_outcomes": true
    }
  ]
}

Поле	Значение
`games[].game_id`	id, который передаётся как `symbol` в `/playGame.do` и `/gameActions.do`
`games[].languages`	Стандартные коды языков, которые игра принимает при запуске (Языки)
`games[].free_spins`	Для игры доступны фриспины оператора
`games[].target_outcomes`	Для игры доступны целевые исходы оператора

В ответе есть и диагностические поля (идентификаторы релиза и сборки); не опирайтесь на них.

Сейчас фриспины поддерживают 445 из 446 игр, целевые исходы — 433. Таблица всех игр с поиском — в списке игр; она формируется из этого метода.

`GET /capabilities`#

json

{
  "status": "ok",
  "mode": "TEST_ONLY",
  "currencies": [{"code": "UAH", "precision": 2}, {"code": "USD", "precision": 2}, {"code": "EUR", "precision": 2}, {"code": "RUB", "precision": 2}],
  "games": [
    {
      "gameId": "gates-of-olympus",
      "name": "Gates of Olympus",
      "provider": "pragmatic",
      "currencies": ["UAH", "USD", "EUR", "RUB"],
      "languages": ["ru", "en", "uk"],
      "defaultCurrency": "UAH",
      "defaultLanguage": "uk",
      "promoSupported": true,
      "modes": ["spin", "ante", "purchase", "promo"]
    }
  ]
}

Поле	Значение
`provider`	`endorphina`, `pragmatic` или `nolimitcity`
`languages`	Только языки казино `ru`, `en`, `uk` — фиксированный контракт для фронтендов казино. Полный список по игре — в `/games/health`
`modes`	Информационные названия режимов игры (например, `spin`, `ante`, `purchase`, `gamble`)
`promoSupported`	Сохранено для совместимости с контрактом казино; для фриспинов оператора используйте `free_spins` из `/games/health`

У некоторых игр есть дополнительные информационные поля (например, configurableRtp). Они необязательны.

`GET /health`#

json

{"status": "ok", "mode": "TEST_ONLY"}

Отвечает HTTP 503 DATABASE_UNAVAILABLE, когда платформа не может обратиться к своему хранилищу. Используйте только для мониторинга доступности; не вызывайте на каждое действие игрока.

Использование каталога в интеграции#

Стройте лобби по /capabilities (названия, провайдеры) и дополняйте данными /games/health (языки, возможности). Кэшируйте данные на несколько минут — они меняются только при публикации игр.
Прежде чем предлагать в бэк-офисе фриспины или целевые исходы, проверьте признаки; иначе API ответит FREE_SPINS_UNSUPPORTED / FORCED_OUTCOMES_UNSUPPORTED.
Какие необязательные режимы доступны проекту (покупка бонуса, ante, риск-игра), настраивается в админ-панели: Projects → Providers.

Каталог и возможности

GET /games/health#

GET /capabilities#

GET /health#

Использование каталога в интеграции#

`GET /games/health`#

`GET /capabilities`#

`GET /health`#