Notell Slots API
Подключите каталог из 1010 слот-игр к своему казино: запускайте игру для игрока одним серверным вызовом, храните баланс в собственном кошельке, выдавайте фриспины, планируйте целевые исходы, настраивайте лимиты и RTP, а управлять всем можно из админ-панели.
Базовый адрес API: https://notell-api.com. Все вызовы выполняются между серверами: JSON поверх HTTPS.
С чего начать#
- Прочитайте обзор и основные понятия.
- Пройдите быстрый старт: от ключей до первой игры за несколько вызовов.
- Реализуйте у себя колбэки кошелька.
- Любой метод ищите в справочнике API, любую ошибку — в справочнике ошибок.
Все разделы#
Начало работыОбзорЧто делает платформа, для кого она и как выглядит интеграция от начала до конца.Начало работыОсновные понятияПроекты, игроки, сессии, раунды, валюты и форматы денежных сумм.Начало работыБыстрый стартОт ключей до первой запущенной игры: пошагово, с рабочими примерами.Начало работыОкруженияПродакшен и тестовое окружение (песочница): адреса и различия.ИнтеграцияАутентификация и безопасностьAPI-ключи, список разрешённых IP, ротация и отзыв ключа, проверка колбэков платформы.ИнтеграцияСоглашенияФормат запросов и ответов, идемпотентность, деньги, даты, идентификаторы, лимиты запросов и предел размера тела.ИнтеграцияЗапуск игрыPOST /playGame.do создаёт сессию игрока и возвращает ссылку на клиент игры: все параметры, ответ и ошибки.ИнтеграцияКолбэки кошелькаКонтракт бесшовного кошелька, который вы реализуете: транспорт, подпись, формат ответа, все методы колбэков, правила повторов и примеры.ИнтеграцияВстраивание в iframeКак разрешить вашему сайту показывать игру в iframe: разрешённые источники по проектам, лимиты и ошибка INVALID_FRAME_ORIGINS.ИнтеграцияКаталог и возможностиПубличные GET-endpoints: опубликованные игры с картинками, категориями, RTP, волатильностью, языками и флагами функций.ВозможностиФриспиныВыдача, чтение, список и отмена фриспинов игроку; жизненный цикл, единое удержанное зачисление выигрыша и итоговый колбэк.ВозможностиЦелевые исходыНазначьте нужный множитель выигрыша на n-й платный спин игрока: методы, статусы, допуск и срок действия.ВозможностиУправление RTPRTP проекта (по умолчанию 90 %), персональный RTP игрока в диапазоне 60–100 %, адаптивное правило и API /playerRtp.do.ВозможностиЛимиты ставок и расширенные ставкиЛимиты ставок проекта, игры и игрока по валютам и как лимит выше родного максимума игры открывает расширенные ставки.ВозможностиДемо-режимБесплатные запуски с gametype "fun": изолированный демо-кошелёк, demo_balance и demo_reset, без колбэков кошелька, ничего не попадает в ваши отчёты.ВозможностиОтмена раунда и возвратыКогда раунд отменяется и возвращается (4xx на bet, неподтверждённая ставка через 10 минут, round_cancel) и что должен сделать ваш кошелёк.ВозможностиAPI отчётовreport_rounds, report_ggr и report_reconciliation: история раундов, GGR и сверка кошелька — методы только для чтения.СправочникСправочник APIУказатель всех endpoints, методов и колбэков кошелька со ссылкой на скачиваемый документ OpenAPI.СправочникСправочник ошибокВсе коды ошибок API, контракта кошелька и API админки — со значением и рекомендацией, что делать.СправочникВалютыФиатные валюты ISO 4217, которые принимает платформа: у всех два знака после запятой.СправочникЯзыкиЯзыки запуска — стандартные коды, алиасы, поддержка по играм, язык проекта и переключение.СправочникСписок игрВсе 1010 игр с провайдером, id, языками и возможностями — формируется из каталога.Админ-панельАдмин-панельЧто можно делать в админ-панели: вход, проекты, ключи и колбэк, RTP и игроки, отчёты, персонал и кабинет клиента.ДополнительноFAQКороткие ответы на вопросы, которые чаще всего задают интеграторы и сотрудники бэк-офиса.ДополнительноЖурнал измененийЗаметные изменения API платформы, каталога и админ-панели, новые сверху.