GAPI API Documentation

Полный reference по API для поиска игр, карточек PSN/Battle.net, лимитов и интеграции.

Основная информация

• Base URL: https://gapi.qb2.ru/api/v1
• Auth Header: Authorization: Bearer gapi_...
• Лимит в минуту: 30 запросов
• Лимит в сутки: 43200 запросов

Что даёт API

Единый поиск

Один endpoint выдаёт унифицированные результаты по PSN и Battle.net с ценами, регионами и ссылками.

Карточки игр

Для PSN возвращаются offers, variants, related items, region cards и store links. Для Battle.net — slug, offers и metadata.

Предсказуемые лимиты

Лимиты не скрыты: они есть и в JSON, и в response headers, и на отдельном endpoint'е usage.

Интеграционный UX

На этой странице можно сразу протестировать запрос, а затем перейти к reference и примерам.

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

1. Получи API key — Войди в аккаунт и создай ключ в личном кабинете
2. Добавь заголовок — Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx
3. Сделай запрос — Используй /catalog/search для поиска игр
4. Проверь лимиты — Смотри headers X-RateLimit-* или endpoint /account/usage

Способы авторизации

Основной способ:

Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx

Альтернативный заголовок:

x-api-key: gapi_xxxxxxxxxxxxxxxxxxxxx

Навигация

• Аутентификация — Как получить и использовать API ключ
• Поиск игр — /catalog/search и /catalog/suggest
• Карточки игр — Детальная информация о играх
• Другие endpoints — Курсы валют, платформы, usage
• Ошибки и лимиты — Обработка ошибок и rate limiting
• Примеры — Готовые сценарии интеграции
• Playground — Интерактивное тестирование API