UnderGames REST API

Доступ к каталогу из 12 000+ игр. Скачивания, библиотеки, покупки, лидерборды — всё через API.

Все системыOperational

Pro

$19/мес
  • 10 000 запросов / мин
  • Полный каталог 12 000+ игр
  • Запись и управление
  • Webhooks + CDN зеркала
  • Приоритетная поддержка

    • Enterprise

    $49/мес
  • 50 000 запросов / мин
  • Выделенный IP
  • SLA 99.99%
  • Персональный менеджер
  • Кастомные интеграции

    • Business

    $149/мес
  • 200 000 запросов / мин
  • Выделенный домен
  • SLA 99.999%
  • 24/7 поддержка
  • Белая метка (white-label)

    • 🎮 Каталог игр — 12 847 релизов

    🔥 Популярные загрузки

    Обзор

    Базовый URL: https://api.undergames.cl/v2

    Все ответы — JSON. Для доступа необходим API-ключ, получаемый после регистрации.

    Быстрый старт

    // npm install @undergames/sdk const { UnderGames } = require('@undergames/sdk'); const client = new UnderGames({ apiKey: 'ug_live_xxxxxxxxxxxxxxxx' }); const games = await client.games.list({ limit: 20 });

    Игры

    GET/v2/games
    Список игр. Пагинация через offset и limit. Фильтры: genre, platform, year.
    GET/v2/games/{game_id}
    Детали игры: описание, жанр, платформы, размер, SHA-256 хеш установщика.
    GET/v2/games/{game_id}/covers
    Обложки: header, capsule, library_600x900, hero.
    POST/v2/games
    Добавить игру. Требует games:write.
    PUT/v2/games/{game_id}/builds
    Загрузить новый билд. Принимает multipart/form-data.
    DELETE/v2/games/{game_id}
    Удалить игру и все билды.

    Пример ответа

    { "id": "g_9kx2m", "title": "Elden Ring", "slug": "elden-ring", "genres": ["RPG", "Souls-like"], "platforms": ["windows"], "release_date": "2022-02-25", "size_gb": 49.7, "sha256": "a3f2c...e91b", "mirrors": [ "https://dl.undergames.cl/g/9kx2m/repack", "https://eu.undergames.cl/g/9kx2m/repack" ], "downloads": 847291, "rating": 9.4 }

    Пользователи

    GET/v2/users/me
    Текущий пользователь: профиль, статистика, библиотека.
    GET/v2/users/{user_id}/library
    Библиотека игр. Статус: downloaded / installed / wishlisted.
    POST/v2/users/{user_id}/library/{game_id}
    Добавить игру в библиотеку.
    GET/v2/leaderboard
    Глобальный лидерборд по загрузкам и активности.

    Магазин и покупки

    GET/v2/store/featured
    Рекомендации и горячие предложения.
    POST/v2/store/purchase
    Совершить покупку. Тело: { game_id, payment_method }.
    GET/v2/store/orders
    История заказов.

    Авторизация

    Заголовок Authorization: Bearer ug_live_xxxxx или OAuth 2.0.

    POST /v2/auth/token { "grant_type": "client_credentials", "client_id": "your_client_id", "client_secret": "your_client_secret" }
    Важно: Не публикуйте client_secret в клиентском коде.

    Ошибки

    КодОписаниеРешение
    400Неверный запросПроверьте тело и параметры
    401Не авторизованПроверьте API-ключ
    403Доступ запрещёнНет прав на ресурс
    404Не найденоРесурс не существует
    429Rate limitПодождите. См. X-RateLimit-Reset
    500Ошибка сервераПовторите позже