Документация/Подключение/Своя панель/Что делает панель, а что вы·5 / 9
Что делает панель, а что вы
Панель — механизм, а не готовый кабинет. Мы не решаем бизнес-задачи вашего сервиса и не подстраиваемся под них: витрина, личный кабинет клиента, CRM — собираете вы, руками или вместе с ИИ.
Что вы получаете
- Консоль
- Команда veli на сервере панели: поставить панель, добавить узлы по IP, завести клиентов, выдать токены и вебхуки. Ничего не нужно открывать в браузере.
- API
- Все те же действия по HTTPS: клиенты, узлы, группы, трафик, события. Схема openapi.json — по ней ИИ или программист строит клиент на любом языке.
- Вебхуки
- Панель сама сообщает о событиях: клиент добавлен, срок кончается, трафик на исходе, узел замолчал. Ваш сервер получает запрос с подписью и делает своё.
- MCP для ИИ
- Тот же API как инструменты для Claude и других агентов: «кто истекает на этой неделе», «продли тем, у кого метка vip». Права — по токену.
Что делает панель
Всё, что связано с доступом к VPN, — надёжно и без вашего участия.
- Хранит клиентов: срок, устройства, скорость, лимит трафика, заметку и ваши метки.
- Отдаёт каждому одну ссылку на все ваши серверы и простую страницу подписки с кнопками приложений.
- Раздаёт список клиентов узлам: новый клиент работает на всех узлах за полминуты.
- Считает трафик и устройства, ведёт журнал действий, хранит удалённых клиентов в корзине 30 дней.
- Сообщает о событиях вебхуками и лентой и отвечает ИИ-агенту по MCP.
Что делаете вы
Всё, что зависит от вашего бизнеса: оно остаётся у вас, панель в это не вмешивается.
- Цены и оплата — Ваш прайс, платёжная система, возвраты, налоги. Панель знает только дни, устройства и трафик — цены и оплата у вас.
- Витрина и кабинет клиента — Сайт или приложение, где человек платит, видит срок и берёт свою ссылку.
- Ваш порядок работы — Кто и что может менять у вас в команде, какие письма и сообщения уходят клиентам, какие отчёты нужны.
- Поддержка и учёт — CRM, заявки, история общения. Клиент связан с вашей системой внешним ID: номер заказа или ID пользователя у вас.
Токен
Сделать токен с нужными правами и сроком — для сайта, CRM или ИИ-агента — и держать его так, чтобы утечка ничего не стоила.
Сделайте токен в консоли
На сервере панели, под root: veli token add <имя> --rights read|clients|all. Токены и вебхуки делает только консоль — не другой токен и не вызов API.
Название, права, срок
Название — кто им пользуется, например cabinet. Права — read, clients или all (ниже). Срок — по желанию: --days 90, от 1 до 3650 дней; без --days токен бессрочный.
Скопируйте токен
Консоль печатает токен один раз: скопируйте его в настройки вашей системы. Потеряли — отзовите и сделайте новый.
veli token add cabinet --rights clients --days 90veli token list
veli token revoke cabinet- Только чтение
- --rights read. Смотреть клиентов без их ссылок, узлы, трафик, ленту событий. Ничего не меняет
- Клиенты
- --rights clients. Смотреть всё, ссылки клиентов тоже, и вести клиентов: добавить, продлить, отключить и включить, сменить ссылку, отвязать устройство, менять многих сразу. Удалять — нет
- Всё
- --rights all. Всё, что может панель: удалять клиентов, вести узлы и группы. Кроме токенов и вебхуков — их делает только консоль
- Адрес API — адрес вашей панели, секретный путь и /api/. Его печатает veli token add под самим токеном (и установка панели). Путь — как пароль: держите его рядом с токеном, не в открытом репозитории.
- Токен идёт в заголовке Authorization: Bearer veli_… — с ваших серверов. Скрипту на странице в браузере панель не ответит.
- Токены и вебхуки по API не создаются, даже токеном «Всё»: утёкший токен не размножит себя. Их делает только консоль.
Пределы
- 300 запросов в минуту на токен. Каждый ответ несёт RateLimit-Limit, RateLimit-Remaining — сколько осталось в этой минуте — и RateLimit-Reset — через сколько секунд минута начнётся заново.
- Сверх предела — 429 wait и Retry-After: 60. Подождите столько секунд и повторите тот же запрос; для POST — с тем же ключом повтора.
Первый запрос
Проверьте токен: GET me отвечает его названием, правами и сроком, а заголовки — сколько запросов осталось в этой минуте.
VELI=https://panel.example.com/Zq7mT2xP4vLc9wRbE5nK/api
VELI_TOKEN=veli_…
curl -si "$VELI/me" \
-H "Authorization: Bearer $VELI_TOKEN"HTTP/1.1 200 OK
content-type: application/json
ratelimit-limit: 300
ratelimit-remaining: 299
ratelimit-reset: 41
{"name": "cabinet", "token": true, "rights": "clients", "until": 0, "api": 1}