KinetX Operator API

Operator API предназначен для API-операторов (headless), которые ведут собственный сайт или приложение, и для Turnkey-операторов, сохраняющих свой фронтенд или платёжного провайдера. Все бизнес-правила платформы действуют для API-вызовов так же, как в бэк-офисе: пороги KYC, лимиты ответственной игры и периоды ожидания, самоисключение, условия бонусов, AML-мониторинг и журнал аудита.

1. 1В бэк-офисе откройте Инструменты → API и вебхуки и создайте API-ключ с нужными правами. Скопируйте секрет: он показывается только один раз.
2. 2При желании ограничьте ключ IP-адресами своих серверов.
3. 3Подпишите запрос к GET /api/v1/operator/me и убедитесь, что он возвращает вашего оператора. Как подписывать запросы →
4. 4Добавьте адрес вебхука, чтобы получать уведомления о регистрациях, платежах, бонусах, KYC и событиях комплаенса.

Базовый URL:

https://kinetx.amhtechnologies.com/api/v1

• Запросы и ответы — в формате JSON (application/json). Успешные ответы оборачивают результат в data.
• Деньги всегда передаются целым числом в минимальных единицах валюты (центах): 12550 — это €125,50. Валюты — коды ISO 4217.
• Метки времени — ISO 8601 в UTC (2026-10-15T09:30:00Z); даты — YYYY-MM-DD.
• Идентификаторы — целочисленные id KinetX. Храните свой id игрока в external_id и ищите игроков по нему.
• Каждый ответ содержит заголовок X-Request-Id; указывайте его при обращении в поддержку.
• API-ключ видит только данные своего оператора: записи других операторов отвечают 404.

Сетевые сбои случаются. Отправляйте заголовок Idempotency-Key (UUID) с каждым POST: первый ответ хранится 24 часа и воспроизводится для каждого повтора с тем же ключом и тем же запросом с отметкой Idempotent-Replayed: true. Повторное использование ключа для другого запроса отклоняется с IDEMPOTENCY_KEY_REUSED; повтор, пока первый запрос ещё выполняется, получает 409 IDEMPOTENCY_IN_PROGRESS.

Движения денег дополнительно идемпотентны по вашей собственной ссылке: депозит с уже записанным external_reference возвращает исходный депозит вместо повторного зачисления.

Ошибки используют HTTP-статусы и единую обёртку со стабильным машиночитаемым кодом:

{
    "error": {
        "code": "VALIDATION_FAILED",
        "message": "The request data is invalid.",
        "details": {
            "birth_date": [
                "The player must be at least 18 years old."
            ]
        }
    }
}

Списочные методы принимают page и per_page (1–100, по умолчанию 25) и возвращают meta и links рядом с данными:

{
    "data": [
        "…"
    ],
    "meta": {
        "current_page": 2,
        "per_page": 25,
        "total": 137,
        "last_page": 6,
        "from": 26,
        "to": 50
    },
    "links": {
        "first": "…?page=1",
        "last": "…?page=6",
        "prev": "…?page=1",
        "next": "…?page=3"
    }
}

Каждый API-ключ по умолчанию может отправлять 600 запросов в минуту (сотрудники могут задать для ключа другой лимит). Токены игроков учитываются в лимите ключа, который их выдал. Каждый ответ сообщает остаток в X-RateLimit-Limit и X-RateLimit-Remaining; при превышении вы получите 429 RATE_LIMITED с заголовком Retry-After.

Версия — часть пути (/api/v1). В пределах v1 мы только добавляем: новые методы, необязательные параметры, поля ответа и события вебхуков. Игнорируйте неизвестные поля. Несовместимые изменения выйдут как v2 и будут заранее объявлены в журнале изменений.