ADRUSH VPN Partner API

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

Минимальная интеграция: после оплаты в вашем боте вызовите provision и отдайте пользователю subscription_url.

curl -sS -X POST "https://sub.adrushvpn.online/api/v1/tenant/users/provision" \
  -H "X-Tenant-Api-Key: YOUR_TENANT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "telegram_id": 123456789,
    "expire_at": "2026-12-31T23:59:59Z",
    "max_devices": 4
  }'

{
  "ok": true,
  "tenant_slug": "vpnshop",
  "telegram_id": 123456789,
  "username": "vpnshop_tg_123456789",
  "remnawave_user_uuid": "3a009f58-c9ac-4fb2-b2f0-7f9618c12f4c",
  "short_uuid": "meCnSTL7Z14je4kb",
  "subscription_url": "https://sub.uppartner.online/meCnSTL7Z14je4kb",
  "expire_at": "2026-12-31T23:59:59.000Z",
  "max_devices": 4,
  "active": true
}

Authentication

Секретный ключ вашего tenant. Передаётся в каждом запросе в заголовке X-Tenant-Api-Key. Ключ выдаётся один раз при подключении; повторно посмотреть его нельзя — только ротация через администратора ADRUSH VPN.

Страница подписки

После provision пользователь открывает subscription_url — это Remnawave Subscription Page на домене партнёра (например https://sub.uppartner.online/{shortUuid}).

• Страница отдаёт конфигурацию VLESS Reality для импорта в Happ.
• Брендинг (логотип, цвета) задаётся через external_squad_uuid в настройках tenant.
• Не используйте домен sub.adrushvpn.online в пользовательских ссылках — только ваш subscription_public_url.

Сценарий интеграции в боте

1. Пользователь оплачивает тариф в вашем Telegram-боте.
2. Вызываете POST /tenant/users/provision с telegram_id и expire_at.
3. Из ответа берёте subscription_url и отправляете кнопкой «Подключить VPN».
4. Пользователь импортирует подписку в Happ.
5. При продлении — extend или повторный provision.
6. При блокировке / chargeback — disable.

Готовый пример бота: репозиторий ADRUSH VPN, каталог partner-bot-example/.

Пример Python (httpx)

import httpx
from datetime import datetime, timedelta, timezone

BASE = "https://sub.adrushvpn.online/api/v1"
KEY = "YOUR_TENANT_KEY"

async def provision_user(telegram_id: int, days: int = 30) -> dict:
    expire = datetime.now(timezone.utc) + timedelta(days=days)
    body = {
        "telegram_id": telegram_id,
        "expire_at": expire.strftime("%Y-%m-%dT%H:%M:%S.000Z"),
        "max_devices": 4,
    }
    async with httpx.AsyncClient(timeout=90.0) as client:
        r = await client.post(
            f"{BASE}/tenant/users/provision",
            headers={"X-Tenant-Api-Key": KEY},
            json=body,
        )
        r.raise_for_status()
        return r.json()

Коды ошибок

Contact

Подключение нового партнёра, ротация API-ключа, настройка домена и брендинга: