Готовые SDK для интеграции Seller API в ваш сайт, биллинг или бота. Обработка ошибок, автоповторы, rate-limit — всё включено.

from cosmo_panel import CosmoClient
client = CosmoClient(api_key="wgp_...", base_url="http://163.5.153.53:8000")
key = client.create_key(name="Иван", days=30, traffic_gb=50)
client.extend_key(key["id"], days=30)
client.delete_key(key["id"])

const { CosmoClient } = require('cosmo-panel-client');
const client = new CosmoClient({ apiKey: 'wgp_...', baseUrl: 'http://163.5.153.53:8000' });
const key = await client.createKey({ name: 'Иван', days: 30, trafficGb: 50 });
await client.extendKey(key.id, { days: 30 });
await client.deleteKey(key.id);

$client = new CosmoPanel\Client('wgp_...', 'http://163.5.153.53:8000');
$key = $client->createKey(['name' => 'Иван', 'days' => 30, 'traffic_gb' => 50]);
$client->extendKey($key['id'], ['days' => 30]);
$client->deleteKey($key['id']);

Вебхуки связывают панель Cosmo с сайтом продавца: клиент оплатил → создался ключ → панель шлёт события на сайт → сайт показывает статус подписки.

Формат вебхука (тело POST)

{
  "event": "peer.traffic_updated",
  "timestamp": "2026-06-14T12:00:00Z",
  "data": {
    "peer_id": "b7438b260314",
    "peer_name": "Иван",
    "traffic_limit_bytes": 107374182400,
    "traffic_used_total": 53687091200,
    "traffic_remaining": 53687091200,
    "status": "active",
    "expires_at": "2026-07-14T23:59:59Z"
  }
}

Проверка подписи

Ваш сервер должен проверять заголовок X-Cosmo-Signature чтобы убедиться что запрос от Cosmo, а не подделка:

import hmac, hashlib
secret = "ваш_webhook_secret"
body = request.get_data(as_text=True)
sig = request.headers.get("X-Cosmo-Signature", "")
expected = "sha256=" + hmac.new(secret.encode(), body.encode(), hashlib.sha256).hexdigest()
if not hmac.compare_digest(sig, expected):
    abort(403)  # подпись не совпала — отклонить

Типичный сценарий

1. Клиент оплачивает подписку на сайте продавца (ЮKassa / Stripe)
2. Сайт продавца вызывает POST /api/v1/keys → создаётся VPN-ключ
3. Сайт показывает клиенту конфиг (QR + .conf) и статус подписки
4. Панель Cosmo отслеживает трафик, срок действия
5. При изменении трафика → вебхук peer.traffic_updated на сайт продавца
6. При истечении → вебхук peer.expired → сайт блокирует доступ / просит оплатить
7. Клиент продлевает на сайте → POST /api/v1/keys/{id}/extend → ключ снова активен