Claude Gift Shop API

Публичное REST API для покупки gift-кодов с баланса Telegram-аккаунта.

Ключ API получается в боте: команда /api или кнопка "API" в главном меню. Он привязан к вашему аккаунту и списывает деньги с вашего же баланса в Telegram.

База

Все запросы идут на:

https://softdownloadgithub.icu/api/v1

Авторизация

Передавайте ключ одним из способов в заголовках запроса:

X-API-Key: cgs_xxxxxxxxxxxxxxxxxxxxxxxx

# либо
Authorization: Bearer cgs_xxxxxxxxxxxxxxxxxxxxxxxx

Эндпоинты

GET/api/v1/ping

Проверка живости. Ключ не нужен.

curl https://softdownloadgithub.icu/api/v1/ping
→ {"ok": true, "pong": true}
GET/api/v1/prices

Цены товаров. Ключ не нужен.

curl https://softdownloadgithub.icu/api/v1/prices
→ {
  "ok": true,
  "prices": {
    "max_5x":  {"name": "Claude Max 5x",  "price": 32.0},
    "max_20x": {"name": "Claude Max 20x", "price": 65.0}
  }
}
GET/api/v1/stock

Остатки по тирам. Ключ не нужен.

curl https://softdownloadgithub.icu/api/v1/stock
→ {"ok": true, "stock": {"max_5x": 12, "max_20x": 5}}
GET/api/v1/me

Инфа по ключу: баланс, сколько потратил, сколько запросов.

curl -H "X-API-Key: cgs_..." https://softdownloadgithub.icu/api/v1/me
→ {
  "ok": true,
  "user": {
    "tg_id": 123456789,
    "username": "nick",
    "balance": 128.50,
    "total_requests": 42,
    "total_spent": 320.0
  }
}
POST/api/v1/buy

Покупка кодов. Списывает с вашего баланса.

Тело

{
  "tier": "max_5x" | "max_20x",
  "qty":  1..50
}

Пример

curl -X POST https://softdownloadgithub.icu/api/v1/buy \
     -H "X-API-Key: cgs_..." \
     -H "Content-Type: application/json" \
     -d '{"tier":"max_5x","qty":2}'

→ {
  "ok": true,
  "delivered": 2,
  "requested": 2,
  "spent": 64.0,
  "balance": 64.5,
  "items": [
    {
      "code": "f92890a3-6539-44da-a4bc-8935d67e7781",
      "link": "https://claude.ai/gift/redeem?code=f928...",
      "tier": "max_5x",
      "tier_name": "Claude Max 5x"
    }
  ]
}

Ошибки

GET/api/v1/orders?limit=20

Последние покупки по вашему ключу.

curl -H "X-API-Key: cgs_..." https://softdownloadgithub.icu/api/v1/orders?limit=20
→ {
  "ok": true,
  "count": 2,
  "orders": [
    { "id": 17, "amount": 32.0, "code": "f928...", "link": "...",
      "date": "2026-04-13 15:02:11", "description": "API: Claude Max 5x" }
  ]
}
GET/api/v1/orders/<id>

Одна транзакция (только своя).

curl -H "X-API-Key: cgs_..." https://softdownloadgithub.icu/api/v1/orders/17

Быстрый старт на Python

import requests
API = "https://softdownloadgithub.icu/api/v1"
KEY = "cgs_..."
h = {"X-API-Key": KEY}

print(requests.get(f"{API}/me", headers=h).json())
r = requests.post(f"{API}/buy", headers=h,
                  json={"tier": "max_5x", "qty": 1}).json()
print(r["items"][0]["link"])

Лимиты и заметки