Как получить и использовать API ключ для доступа к GAPI

Аутентификация

Все запросы к GAPI API требуют аутентификации через API ключ.

Получение API ключа

Шаг 1: Регистрация

Войдите в систему через страницу авторизации

Шаг 2: Создание ключа

Перейдите в личный кабинет и создайте новый API ключ

Шаг 3: Сохранение ключа

Скопируйте ключ в безопасное место. Ключ имеет формат gapi_xxxxxxxxxxxxxxxxxxxxx

API ключ показывается только один раз при создании. Сохраните его в безопасном месте.

Использование ключа

Основной способ (Bearer Token)

Рекомендуемый способ — использовать заголовок Authorization с Bearer токеном:

curl -H "Authorization: Bearer gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/search?q=god+of+war"

Альтернативный способ (x-api-key)

Также поддерживается заголовок x-api-key:

curl -H "x-api-key: gapi_xxxxxxxxxxxxxxxxxxxxx" \
  "https://gapi.qb2.ru/api/v1/catalog/search?q=god+of+war"

Примеры на разных языках

JavaScript (fetch)

const apiKey = 'gapi_xxxxxxxxxxxxxxxxxxxxx';

const response = await fetch('https://gapi.qb2.ru/api/v1/catalog/search?q=god+of+war', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const data = await response.json();
console.log(data);

Python (requests)

import requests

api_key = 'gapi_xxxxxxxxxxxxxxxxxxxxx'

response = requests.get(
    'https://gapi.qb2.ru/api/v1/catalog/search',
    params={'q': 'god of war'},
    headers={'Authorization': f'Bearer {api_key}'}
)

data = response.json()
print(data)

PHP (cURL)

<?php
$apiKey = 'gapi_xxxxxxxxxxxxxxxxxxxxx';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://gapi.qb2.ru/api/v1/catalog/search?q=god+of+war');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

C# (HttpClient)

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var apiKey = "gapi_xxxxxxxxxxxxxxxxxxxxx";
        var client = new HttpClient();
        
        client.DefaultRequestHeaders.Add("Authorization", $"Bearer {apiKey}");
        
        var response = await client.GetAsync(
            "https://gapi.qb2.ru/api/v1/catalog/search?q=god+of+war"
        );
        
        var content = await response.Content.ReadAsStringAsync();
        Console.WriteLine(content);
    }
}

Проверка ключа

Используйте endpoint /account/me для проверки валидности ключа:

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
  }
}

Управление ключами

Просмотр ключей — В личном кабинете
Создание нового ключа — Можно создать несколько ключей для разных проектов
Отзыв ключа — Деактивируйте скомпрометированный ключ в личном кабинете
Срок действия — Ключи могут иметь срок действия или быть бессрочными

Рекомендуется использовать отдельные ключи для разных проектов и окружений (dev/prod).

Аутентификация

On this page