Интерактивный справочник API

Изучайте рабочий API и выполняйте синтетические запросы в бесплатной песочнице. Существующие адреса API и интеграции остаются прежними.

От песочницы к первому реальному заказу

Сначала попробуйте безопасный пример, затем подключите свой сервер за пять шагов.

Try it out работает только в песочнице ниже. Справочник рабочего API доступен лишь для чтения; реальные запросы отправляйте со своего сервера.

  1. Попробуйте бесплатный тест

    В песочнице ниже нажмите «Создать сессию». Откройте метод и выберите Try it out → Execute. Используются только тестовые данные и TEST_USDT; реальные деньги не списываются.

  2. Создайте настоящий API-ключ

    Откройте раздел API-ключа в профиле. Создайте ключ и пройдите запрошенную проверку паролем/2FA. Сохраните полный ключ, когда он появится. Храните его только на своём сервере, не в коде браузера и не на этой странице.

  3. Проверьте доступ со своего сервера

    Используйте базовый адрес ниже и передавайте ключ в заголовке X-API-Key. Сначала вызовите GET /me или GET /balance: это проверка доступа без создания заказа.

  4. Выберите реальный товар

    Вызовите GET /catalog, затем GET /catalog/{game_key}. Выберите нужный товар и регион. Используйте полученные game_key, variation_id и обязательные поля товара, например player_id или zone_id. Не отправляйте тестовые ключи, sandbox_game, sandbox_pack или scenario.

  5. Создайте заказ и проверьте результат

    Убедитесь, что реального баланса хватает на покупку. Отправьте POST /order в формате JSON с уникальным Idempotency-Key для каждого нового заказа. При таймауте повторите точно тот же запрос с тем же ключом; не создавайте новый ключ для повтора.

    HTTP 201 означает, что заказ создан, а не выполнен. Проверяйте GET /order/{id} или webhook после проверки его подписи. Только COMPLETED подтверждает выполнение; также обрабатывайте ошибки и возвраты.

Базовый адрес рабочего API

https://api.ludovex.org/api/v2

Задайте LUDOVEX_API_KEY как переменную окружения на своём сервере. Этот пример — только текст; не вставляйте настоящий ключ на эту страницу.

Перейти к песочнице нижеОткрыть настройки API-ключаЧитать полное руководство по интеграции

Первая проверка без покупки: GET /balance

curl --fail-with-body "https://api.ludovex.org/api/v2/balance" \
  -H "X-API-Key: $LUDOVEX_API_KEY" \
  -H "Accept: application/json"

Тестовый каталог, баланс и моделируемые заказы. Примеры не воспроизводят каждый метод рабочего API. Без реальных денег, обращений к поставщикам и внешней доставки вебхуков.

Временная тестовая сессия

Нажмите «Создать сессию» на этой странице для автоматического подключения. Временный тестовый ключ хранится только в памяти; вставлять ключ не нужно.

Создайте сессию для вызова защищённых тестовым ключом методов.

Выполнение POST /sessions ниже создаёт отдельную сессию. Для автоматического подключения используйте кнопку страницы выше.

Имена методов, поля схемы и технические элементы Swagger используют английскую терминологию API.

Открыть этот OpenAPI JSON

Загрузка справочника API…

Swagger UI 5.34.0 · лицензия Apache 2.0