VooPLAY Developer Portal v1.0

ДОКУМЕНТАЦИЯ
API

Интегрируйте свои проекты в единую игровую экосистему VooPLAY.

API Status
Operational
14ms
Среднее время отклика

01 БЫСТРЫЙ СТАРТ

Для кого это?

Наше API предназначено для разработчиков игр, ботов и сервисов, которые хотят использовать единую базу пользователей и общий баланс VooPLAY.

Как начать?

В текущей версии v1 авторизация происходит автоматически, если пользователь авторизован на сайте vooplay.fun. Просто делайте запросы из браузера или Mini App.

02 ОСНОВЫ

Base URL https://vooplay.fun/api/v1

Все запросы выполняются методом GET. Ответы возвращаются в формате JSON.

03 МЕТОДЫ API

Данные пользователя

Action: get_user
GET /api/v1?action=get_user

Возвращает профиль текущего игрока. Используйте это для отображения ника и баланса в вашей игре.

{
  "success": true,
  "user": {
    "id": 1,
    "username": "VooPlayer",
    "balance": 150.50,
    "role": "user"
  }
}

Новости платформы

Action: get_news
GET /api/v1?action=get_news&limit=3

Получение списка последних новостей VooPLAY для отображения в лаунчере или меню игры.

{
  "success": true,
  "news": [
    {
      "title": "Запуск экосистемы",
      "content": "Мы рады объявить о запуске...",
      "image_url": "https://..."
    }
  ]
}

04 ИНСТРУКЦИИ

Безопасность и доступ

Для обеспечения безопасности ваших данных и данных пользователей, мы используем следующие правила:

  • Авторизация: В текущей версии API работает через сессионные куки. Это значит, что ваша игра должна запускаться в том же браузере, где пользователь вошел в VooPLAY.
  • CORS: Если ваша игра находится на другом домене, запросы могут блокироваться браузером. Мы рекомендуем использовать проксирование или запускать игры на поддоменах *.vooplay.fun.
  • Размещение: Если вы хотите добавить свою игру в нашу экосистему, свяжитесь с нами. Мы предоставим вам место на наших серверах и добавим игру в общий каталог платформы.
  • Лимиты: Ограничение в 60 запросов в минуту защищает систему от перегрузок. При превышении вы получите ошибку 429.

Пример на JavaScript (Fetch) 

fetch('https://vooplay.fun/api/v1?action=get_user')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('Привет, ' + data.user.username);
      console.log('Ваш баланс: ' + data.user.balance + ' руб.');
    }
  });

Важные ограничения

  • Запросы должны выполняться с того же домена или иметь настроенные CORS заголовки.
  • Лимит запросов: не более 60 в минуту на один IP.
  • Запрещено передавать данные сессии третьим лицам.

НУЖНА ПОМОЩЬ?

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

Написать в Telegram