Документация проекта @BolsStore_bot

@BolsStore_bot — отдельный управляющий бот для создания и настройки зеркал Telegram-магазина.
Поддержка: @dywu_ymerwux.

Создание зеркала:
1. Создайте нового бота через @BotFather.
2. Отправьте токен в @BolsStore_bot командой /create.
3. Дождитесь ручного одобрения администратора.
4. После одобрения зеркало получает каталог, оплату и автоматическую выдачу.
Покупки в @BolsStore_bot отключены: он используется только для управления зеркалами.

API зеркал
Базовый адрес: https://gordstore.vip/api/v1

Авторизация: заголовок X-API-Key с ключом из профиля Telegram-бота.
Для каждой покупки обязателен новый заголовок Idempotency-Key.

GET /catalog
Получить категории, товары, цены и остатки. Поле id — это item_id для покупки.

GET /catalog/ids
Короткий список id, name, category, price_rub и available_quantity. Требуется X-API-Key.

GET /api/public/catalog
Публичный каталог без API-ключа. Он не запускает оплату или выдачу.

GET /api/public/catalog/ids
Публичный список идентификаторов товаров для интеграций.

GET /balance
Получить баланс владельца API-ключа.

POST /gemini-18m/check
Проверить до 50 ссылок активации Gemini 18 months. Требуется X-API-Key.
Тело:
{
  "links": ["https://serviceactivation.google.com/subscription/new/..."]
}
Ответ для каждой ссылки содержит status: valid, invalid или unverified.
Ссылки не сохраняются и не попадают в журнал приложения.

POST /purchases
Купить товар за подтверждённый баланс.
Заголовки:
  X-API-Key: ВАШ_КЛЮЧ
  Idempotency-Key: уникальный-id-заказа
Тело:
{
  "item_id": 7,
  "quantity": 1
}

GET /purchases/{purchase_id}
Получить JSON с результатом покупки и выданным товаром.

Цена и наличие всегда пересчитываются сервером. Выдача выполняется только после успешного списания подтверждённого баланса. Повтор одного Idempotency-Key не спишет деньги второй раз.

Интерактивная документация: https://gordstore.vip/api/docs