GAPI Documentation

Карточки игр

Детальная информация о играх PSN и Battle.net

Карточки игр

Получение детальной информации о конкретной игре.

GET /catalog/games/:gameId

Полная карточка игры из PlayStation Store.

Возвращает offers, variants, related items, region cards и store links.

Параметры

ПараметрТипОбязательныйОписание
gameIdstringДаID игры в PSN (например, 6754AQWE)

Пример запроса

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/games/6754AQWE"
const gameId = '6754AQWE';

const response = await fetch(
  `https://gapi.qb2.ru/api/v1/catalog/games/${gameId}`,
  {
    headers: {
      'Authorization': 'Bearer gapi_xxxxxxxxxxxxxxxxxxxxx'
    }
  }
);

const data = await response.json();
import requests

game_id = '6754AQWE'

response = requests.get(
    f'https://gapi.qb2.ru/api/v1/catalog/games/{game_id}',
    headers={'Authorization': 'Bearer gapi_xxxxxxxxxxxxxxxxxxxxx'}
)

data = response.json()

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

{
  "ok": true,
  "data": {
    "id": "6754AQWE",
    "platform": "psn",
    "title": "God of War Ragnarök",
    "description": "Кратос и Атрей отправляются в путешествие...",
    "type": "game",
    "thumbnail": "https://...",
    "images": {
      "cover": "https://...",
      "screenshots": ["https://...", "https://..."]
    },
    "price": {
      "value": 4999,
      "currency": "RUB",
      "formatted": "4 999 ₽",
      "discount": {
        "percentage": 20,
        "originalPrice": 6249,
        "endsAt": "2026-05-15T23:59:59.000Z"
      }
    },
    "regions": ["ru", "us", "eu"],
    "releaseDate": "2022-11-09",
    "publisher": "Sony Interactive Entertainment",
    "developer": "Santa Monica Studio",
    "genres": ["Action", "Adventure"],
    "rating": {
      "age": "18+",
      "system": "PEGI"
    },
    "storeUrl": "https://store.playstation.com/...",
    "related": [
      {
        "id": "6754AQWE_DLC1",
        "title": "God of War Ragnarök - Valhalla",
        "type": "dlc",
        "price": {
          "value": 0,
          "currency": "RUB",
          "formatted": "Бесплатно"
        }
      }
    ],
    "variants": [
      {
        "id": "6754AQWE_DELUXE",
        "title": "God of War Ragnarök Digital Deluxe Edition",
        "type": "edition",
        "price": {
          "value": 6999,
          "currency": "RUB",
          "formatted": "6 999 ₽"
        }
      }
    ]
  },
  "meta": {
    "timestamp": "2026-05-05T13:45:00.000Z",
    "rateLimit": {
      "limit": 30,
      "remaining": 26,
      "resetAt": "2026-05-05T14:00:00.000Z"
    }
  }
}

GET /catalog/battlenet/games/:slug

Карточка игры из Battle.net.

Параметры

ПараметрТипОбязательныйОписание
slugstringДаSlug игры в Battle.net (например, diablo-iv)

Пример запроса

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/battlenet/games/diablo-iv"

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

{
  "ok": true,
  "data": {
    "slug": "diablo-iv",
    "platform": "battlenet",
    "title": "Diablo IV",
    "description": "Бесконечная битва между Высшими Небесами и Пылающими Безднами...",
    "type": "game",
    "thumbnail": "https://...",
    "images": {
      "cover": "https://...",
      "logo": "https://...",
      "screenshots": ["https://...", "https://..."]
    },
    "offers": [
      {
        "id": "diablo-iv-base",
        "title": "Diablo IV",
        "type": "base",
        "price": {
          "value": 2999,
          "currency": "RUB",
          "formatted": "2 999 ₽"
        }
      },
      {
        "id": "diablo-iv-ultimate",
        "title": "Diablo IV Ultimate Edition",
        "type": "edition",
        "price": {
          "value": 5999,
          "currency": "RUB",
          "formatted": "5 999 ₽"
        }
      }
    ],
    "releaseDate": "2023-06-06",
    "publisher": "Blizzard Entertainment",
    "developer": "Blizzard Entertainment",
    "genres": ["Action RPG", "Hack and Slash"],
    "rating": {
      "age": "18+",
      "system": "ESRB"
    },
    "storeUrl": "https://www.blizzard.com/..."
  },
  "meta": {
    "timestamp": "2026-05-05T13:45:00.000Z",
    "rateLimit": {
      "limit": 30,
      "remaining": 25,
      "resetAt": "2026-05-05T14:00:00.000Z"
    }
  }
}

Структура данных

Типы контента

  • game — Основная игра
  • dlc — Дополнительный контент
  • edition — Специальное издание (Deluxe, Ultimate и т.д.)
  • bundle — Набор игр
  • season-pass — Сезонный пропуск

Информация о ценах

Все цены включают:

  • value — Цена в копейках/центах
  • currency — Код валюты (RUB, USD, EUR)
  • formatted — Отформатированная строка с символом валюты
  • discount — Информация о скидке (если есть)

Региональные данные

PSN игры содержат массив regions с доступными регионами:

  • ru — Россия
  • us — США
  • eu — Европа
  • uk — Великобритания
  • jp — Япония

Цены и доступность могут различаться в зависимости от региона.

Связанный контент

Массив related содержит связанные товары:

  • DLC и дополнения
  • Сезонные пропуски
  • Косметические наборы

Variants (PSN)

Массив variants содержит альтернативные издания:

  • Standard Edition
  • Deluxe Edition
  • Ultimate Edition
  • Collector's Edition

Offers (Battle.net)

Массив offers содержит все доступные предложения для игры.

Обработка ошибок

404 Not Found

Игра не найдена или ID/slug неверный:

{
  "ok": false,
  "error": {
    "code": "GAME_NOT_FOUND",
    "message": "Игра с указанным ID не найдена"
  }
}

503 Service Unavailable

Внешний сервис (PSN/Battle.net) недоступен:

{
  "ok": false,
  "error": {
    "code": "UPSTREAM_ERROR",
    "message": "Сервис PlayStation Store временно недоступен"
  }
}

On this page