Курсы валют, платформы, информация об аккаунте и usage

Другие endpoints

Дополнительные endpoints для работы с API.

GET /catalog/exchange-rates

Актуальные курсы валют для конвертации цен.

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

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/exchange-rates"

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

{
  "ok": true,
  "data": {
    "base": "RUB",
    "rates": {
      "USD": 0.011,
      "EUR": 0.010,
      "GBP": 0.009,
      "JPY": 1.65
    },
    "updatedAt": "2026-05-05T12:00:00.000Z"
  }
}

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

GET /catalog/platforms

Список поддерживаемых платформ и их статус.

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

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/platforms"

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

{
  "ok": true,
  "data": {
    "platforms": [
      {
        "id": "psn",
        "name": "PlayStation Store",
        "status": "operational",
        "regions": ["ru", "us", "eu", "uk", "jp"],
        "features": {
          "search": true,
          "details": true,
          "prices": true,
          "related": true
        }
      },
      {
        "id": "battlenet",
        "name": "Battle.net",
        "status": "operational",
        "regions": ["global"],
        "features": {
          "search": true,
          "details": true,
          "prices": true,
          "related": false
        }
      }
    ]
  }
}

Статусы платформ

operational — Работает нормально
degraded — Работает с задержками
outage — Недоступна

GET /account/me

Информация о текущем API ключе.

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

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/account/me"

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

{
  "ok": true,
  "data": {
    "keyId": "abc123",
    "name": "My API Key",
    "status": "active",
    "createdAt": "2026-01-15T10:30:00.000Z",
    "expiresAt": null,
    "lastUsedAt": "2026-05-05T13:45:00.000Z",
    "permissions": ["read:catalog", "read:account"]
  }
}

Статусы ключа

active — Активен и работает
expired — Срок действия истёк
revoked — Отозван пользователем
suspended — Приостановлен администратором

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

GET /account/usage

Текущее использование API и лимиты.

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

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/account/usage"

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

{
  "ok": true,
  "data": {
    "minute": {
      "limit": 30,
      "used": 3,
      "remaining": 27,
      "resetAt": "2026-05-05T14:00:00.000Z"
    },
    "day": {
      "limit": 43200,
      "used": 124,
      "remaining": 43076,
      "resetAt": "2026-05-06T00:00:00.000Z"
    },
    "history": {
      "last24h": 124,
      "last7d": 856,
      "last30d": 3421
    }
  },
  "meta": {
    "timestamp": "2026-05-05T13:45:00.000Z"
  }
}

Структура лимитов

Каждый период (minute, day) содержит:

limit — Максимальное количество запросов
used — Использовано запросов
remaining — Осталось запросов
resetAt — Время сброса счётчика (ISO 8601)

История использования

Объект history показывает статистику:

last24h — Запросов за последние 24 часа
last7d — Запросов за последние 7 дней
last30d — Запросов за последние 30 дней

Проверка здоровья API

GET /health

Публичный endpoint без авторизации для проверки доступности API.

curl "https://gapi.qb2.ru/api/v1/health"

Ответ:

{
  "ok": true,
  "status": "healthy",
  "version": "1.0.0",
  "uptime": 86400
}

Общие заголовки ответа

Все endpoints возвращают заголовки с информацией о лимитах:

X-RateLimit-Limit-Minute: 30
X-RateLimit-Remaining-Minute: 27
X-RateLimit-Reset-Minute: 2026-05-05T14:00:00.000Z
X-RateLimit-Limit-Day: 43200
X-RateLimit-Remaining-Day: 43076
X-RateLimit-Reset-Day: 2026-05-06T00:00:00.000Z

Используйте эти заголовки для отслеживания лимитов без дополнительных запросов к /account/usage.

Другие endpoints

On this page