Справочник методов API

Эта страница — сгруппированный по разделам справочник основных методов, с которыми работает оператор панели. Он покрывает административный API, публичные методы и методы агента.

Для кого: разработчик, интегрирующийся с Axottle; администратор, автоматизирующий рутину. Требуемые права: действующая сессия администратора для методов с доступом «Сессия». Начните с Обзора API, Аутентификации и Соглашений.

Это курируемый список главных методов, а не исчерпывающий машинный список OpenAPI. Машиночитаемая спецификация OpenAPI запланирована, но пока не публикуется. Если метода нет в таблицах ниже — это не значит, что его не существует; здесь собрано то, что чаще всего нужно оператору.

Как читать таблицы

Базовый адрес. Все пути с префиксом /api/v1 располагаются на адресе вашей панели, например https://panel.example.com/api/v1. Пути, начинающиеся с /agent, /s, /health или /install, живут в корне (без /api/v1).
Параметры пути записаны в фигурных скобках: {id}, {token}, {node_id}.
Колонка «Доступ» принимает значения:
- Публичный — аутентификация не требуется.
- Сессия — нужен токен сессии администратора (Authorization: Bearer <session-token>).
- Токен агента — метод вызывает агент ноды своим токеном, а не сессией администратора; вручную не вызывается.
- Публичный (троттлинг) — публичный метод с ограничением частоты запросов (429 + Retry-After).

Все методы /api/v1 с доступом «Сессия» дополнительно подчиняются проверке лицензии: в деградированном режиме («только чтение») изменяющие запросы отклоняются с 403, а доступ к чтению зависит также от лицензионного допуска конкретного раздела. Исключение — методы восстановления: лицензия (/api/v1/license/*), самообновление панели (/api/v1/panel/*), маршруты агента (/api/v1/agent/*) и аутентификация (/api/v1/auth/*) остаются доступными для записи. Подробнее — Лицензия.

Доступ «Сессия» означает действующую сессию, но не безусловный доступ: методы дополнительно проверяют права учётной записи. Запрос к разделу, на который у пользователя нет права, отклоняется с 403 и сообщением, называющим требуемое право. Учётная запись с полным доступом проходит все проверки. Справочник прав по разделам — Права доступа.

Во всех примерах используются плейсхолдеры (panel.example.com, {id}, axt_xxxxxxxx...).

Аутентификация и сессии

Метод	Путь	Доступ	Назначение
POST	`/api/v1/auth/login`	Публичный	Вход по `{username, password}`; возвращает токен сессии и срок действия
POST	`/api/v1/auth/logout`	Сессия	Завершить текущую сессию (работает и в режиме «только чтение»)
GET	`/api/v1/auth/me`	Сессия	Текущий пользователь: id, имя, отображаемое имя, права (`permissions`), признак суперпользователя
GET	`/api/v1/setup/status`	Публичный	Флаги шагов первичной установки
POST	`/api/v1/setup/mode`	Публичный	Режим панели: с Remnawave или автономный
POST	`/api/v1/setup/admin`	Публичный (до создания администратора)	Создать единственного администратора; пароль не короче 8 символов
POST	`/api/v1/setup/license`	Публичный	Активировать лицензионный ключ
POST	`/api/v1/setup/domain`	Публичный	Задать домен и режим SSL
POST	`/api/v1/setup/domain/check`	Публичный	Проверить DNS-запись домена
POST	`/api/v1/setup/remnawave/bootstrap`	Публичный	Авто-подключение совместно установленной Remnawave (только для таких установок)

Методы /api/v1/setup/* доступны только во время первичной установки; создание администратора отклоняется после появления первого администратора. Подробнее: Аутентификация, Доступ и сессии.

Учётные записи и права

Метод	Путь	Доступ	Назначение
GET	`/api/v1/auth/permissions`	Сессия	Справочник прав, сгруппированный по разделам панели (словарь для интерфейса)
GET	`/api/v1/auth/accounts`	Сессия + `accounts.manage`	Список учётных записей: способы входа, права, роль в поддержке, последний вход
POST	`/api/v1/auth/accounts`	Сессия + `accounts.manage`	Создать пользователя: профиль, способ входа, права (`permissions`), роль в поддержке
PATCH	`/api/v1/auth/accounts/{id}`	Сессия + `accounts.manage`	Изменить отображаемое имя, статус, права или роль в поддержке
DELETE	`/api/v1/auth/accounts/{id}`	Сессия + `accounts.manage`	Удалить учётную запись
POST	`/api/v1/auth/change-password`	Сессия	Сменить свой пароль; остальные сессии завершаются

Права передаются массивом ключей: {"permissions": ["nodes.view", "nodes.edit"]}. Полный доступ обозначается одним элементом ["*"], и он же подставляется, если поле не передано. Ограничения при изменении прав:

Ситуация	Ответ
Изменение прав собственной учётной записи	`400`
Неизвестный ключ права или пустой список	`400`
Ограниченный набор прав без возможности `core.rbac` в лицензии	`403`
Попытка ограничить права суперпользователя	`409`
Попытка ограничить последнего пользователя с полным доступом	`409`

Изменения применяются со следующего запроса пользователя; сессии при этом не завершаются. Подробнее: Права доступа, Учётные записи и вход.

Система и статус

Метод	Путь	Доступ	Назначение
GET	`/health`	Публичный	Проверка живости: статус, метка времени, версия
GET	`/ping`	Публичный	Простой ответ `200` (используется скриптом обновления)
GET	`/api/v1/system/status`	Публичный	Статус панели, подключение к БД, `setup_done`, uptime
GET	`/api/v1/panel/version`	Публичный	Текущая и доступная версия панели
POST	`/api/v1/panel/check`	Сессия	Принудительная проверка обновлений панели
GET	`/api/v1/panel/checks`	Сессия	История проверок обновлений
GET/PUT	`/api/v1/panel/update-config`	Сессия	Источник обновлений панели (секреты скрыты)
POST	`/api/v1/panel/upgrade`	Сессия	Запустить обновление панели (отдельным процессом)
GET	`/api/v1/panel/upgrade/status`	Сессия	Состояние обновления, восстановленное с диска

Подробнее: Обновления панели.

Flow (Конфиги)

Flow — пользовательское название Connection Unit. Пути /api/v1/connection-units, поля идентификаторов и права connection_units.* не переименованы. Для всех методов ниже нужна сессия; дополнительно проверяются указанное право и применимые возможности лицензии.

Метод	Путь	Право	Назначение
GET	`/api/v1/connection-units`	`connection_units.view`	Список Flow, включая состояние черновика, применения и наблюдений
POST	`/api/v1/connection-units`	`connection_units.create`	Создать обычный Flow
GET	`/api/v1/connection-units/node-occupancies`	`connection_units.view`	Использование физических нод разными Flow
GET	`/api/v1/connection-units/{id}`	`connection_units.view`	Прочитать Flow
PATCH	`/api/v1/connection-units/{id}`	`connection_units.edit`	Изменить параметры
DELETE	`/api/v1/connection-units/{id}`	`connection_units.delete`	Удалить Flow и очистить управляемые ресурсы
GET	`/api/v1/connection-units/{id}/delete-preview`	`connection_units.view`	Влияние удаления
GET	`/api/v1/connection-units/{id}/graph`	`connection_units.view`	Прочитать граф
PUT	`/api/v1/connection-units/{id}/graph`	`connection_units.edit`	Сохранить черновик графа
POST	`/api/v1/connection-units/{id}/autosave`	`connection_units.edit`	Автосохранение графа
POST	`/api/v1/connection-units/{id}/discard-draft`	`connection_units.edit`	Сбросить черновик к применённому снимку
GET	`/api/v1/connection-units/{id}/versions`	`connection_units.view`	История версий
GET	`/api/v1/connection-units/{id}/versions/{versionId}`	`connection_units.view`	Снимок версии
POST	`/api/v1/connection-units/{id}/compile`	`connection_units.edit`	Собрать план
GET	`/api/v1/connection-units/{id}/compile-plan`	`connection_units.view`	Последний план
POST	`/api/v1/connection-units/{id}/lint`	`connection_units.view`	Статический аудит конфигурации
POST	`/api/v1/connection-units/{id}/preflight`	`connection_units.apply`	Линтер и план предварительной проверки
POST	`/api/v1/connection-units/{id}/apply`	`connection_units.apply`	Развернуть просмотренный план; требуется возможность применения по лицензии
GET	`/api/v1/connection-units/{id}/failure-scenarios`	`connection_units.view`	Сценарии Failure Lab
POST	`/api/v1/connection-units/{id}/simulate`	`connection_units.view`	Расчёт отказа без изменения инфраструктуры
GET	`/api/v1/connection-units/verification`	`connection_units.view`	Состояние стендовых проверок
GET	`/api/v1/connection-units/verification/profile-template`	`connection_units.view`	Шаблон профиля стенда

Поиск и проверка целей REALITY

Метод	Путь	Право	Назначение
POST	`/api/v1/connection-units/reality-target-scans/estimate`	`connection_units.edit`	Оценить задание поиска
GET	`/api/v1/connection-units/reality-target-scans`	`connection_units.view`	Список заданий
POST	`/api/v1/connection-units/reality-target-scans`	`connection_units.edit`, `nodes.operate`	Запустить поиск с ноды
GET	`/api/v1/connection-units/reality-target-scans/{jobId}`	`connection_units.view`	Состояние задания
POST	`/api/v1/connection-units/reality-target-scans/{jobId}/cancel`	`connection_units.edit`, `nodes.operate`	Запросить отмену
GET	`/api/v1/connection-units/reality-target-candidates`	`connection_units.view`	Кандидаты и свежесть данных
POST	`/api/v1/connection-units/reality-target-candidates/{candidateId}/verify`	`connection_units.edit`, `nodes.operate`	Отдельная проверка пригодности
GET	`/api/v1/connection-units/reality-target-candidates/{candidateId}/verification`	`connection_units.view`	Последняя проверка кандидата
DELETE	`/api/v1/connection-units/reality-target-candidates/{candidateId}`	`connection_units.edit`	Архивировать кандидата
POST	`/api/v1/connection-units/reality-target-candidates/{candidateId}/restore`	`connection_units.edit`	Восстановить запись каталога

Поиск не меняет работающий Flow. Для применения цели нужна актуальная пригодность и обычный проверенный план Flow.

Применение просмотренного плана

После компиляции используйте id и revision полученного плана:

{
  "expected_compile_plan_id": "<plan-id>",
  "expected_compile_revision": "<plan-revision>",
  "enable_remnawave_serve_json_at_base_subscription": false,
  "confirm_unresolved_dns": false,
  "force_recreate_remnawave_resources": false,
  "force_apply": false
}

Это форма запроса панели, а не универсальное разрешение на применение. Параметры подтверждения включаются только после просмотра соответствующих изменений. При устаревшем плане или изменении пула выполните новую компиляцию и повторный просмотр; не повторяйте применение старой ревизии вслепую. force_apply — отдельное явное принятие риска неподтверждённой готовности слушателей, firewall и цели REALITY. Оно не отменяет ошибки компиляции, найденные конфликты портов или проверку ревизии. Результат сохраняет сведения об обойдённых проверках: границы режима. Ручная кнопка «Версии → Откатить» получает снимок версии и сохраняет его в граф черновика, после чего требуется применение. Отдельный маршрут /rollback для этой кнопки не используется.

Транзитные пулы и политики

Метод	Путь	Доступ	Назначение
GET/POST	`/api/v1/node-groups`	Сессия + `nodes.view` / `nodes.edit`	Список / создание пула
GET/PUT/DELETE	`/api/v1/node-groups/{id}`	Сессия + `nodes.view` / `nodes.edit`	Чтение / изменение графа и политики / удаление
PUT	`/api/v1/node-groups/{id}/members`	Сессия + `nodes.edit`	Изменение состава с учётом ограничений графа
GET	`/api/v1/node-groups/{id}/flow-impact`	Сессия + `nodes.view`	Затронутые Flow
POST	`/api/v1/node-groups/{id}/relink/preview`	Сессия + `nodes.edit`	Предварительное влияние перепривязки
POST	`/api/v1/node-groups/{id}/relink/review`	Сессия + `nodes.edit`	Проверка плана перепривязки
POST	`/api/v1/node-groups/{id}/relink/apply`	Сессия + `nodes.edit`, `connection_units.apply`	Управляемое применение к Flow
GET	`/api/v1/node-groups/{id}/relink/apply/{operationID}`	Сессия + `nodes.view`, `connection_units.view`	Состояние операции
POST	`/api/v1/node-groups/{id}/relink/apply/{operationID}/rollback`	Сессия + `nodes.edit`, `connection_units.apply`	Откат операции
GET/POST	`/api/v1/transit-pool-policies`	Сессия + `nodes.view` / `nodes.edit`	Список / создание переиспользуемой политики
GET/PUT/DELETE	`/api/v1/transit-pool-policies/{id}`	Сессия + `nodes.view` / `nodes.edit`	Чтение / изменение / удаление политики

Совместимый адрес политик /api/v1/flow-balancers также сохранён. Сохранение каталога не разворачивает новый снимок в работающие Flow.

Здоровье и Flow Guard

Методы этой группы требуют health.view для чтения и health.manage для изменения, а также доступности соответствующих операций по лицензии.

Метод	Путь	Назначение
GET	`/api/v1/health/connection-units/analytics`	Сводная аналитика Flow
GET	`/api/v1/health/connection-units/{id}/diagnostics`	Диагностика работающей версии
GET	`/api/v1/health/connection-units/{id}/destination-failures`	Наблюдения отказов назначений
GET	`/api/v1/health/connection-units/{id}/timeline`	История инцидентов и операций
GET	`/api/v1/health/connection-units/{id}/recovery/plans`	Доступные планы восстановления
GET/PUT	`/api/v1/health/connection-units/{id}/recovery/autonomy`	Чтение / сохранение политики автоматики
GET/POST	`/api/v1/health/connection-units/{id}/recovery/custom-plans`	Список / создание пользовательского плана
POST	`/api/v1/health/connection-units/{id}/recovery/custom-plans/validate`	Проверка плана без запуска
GET/PUT/DELETE	`/api/v1/health/connection-units/{id}/recovery/custom-plans/{planId}`	Чтение / изменение / архивирование плана
POST	`/api/v1/health/connection-units/{id}/recovery/dry-run`	Предварительная проверка восстановления
GET/POST	`/api/v1/health/connection-units/{id}/recovery/runs`	История / создание запуска
GET	`/api/v1/health/connection-units/{id}/recovery/runs/{runId}`	Результат запуска и его шагов
POST	`/api/v1/health/connection-units/{id}/recovery/runs/{runId}/approve`	Подтвердить план
POST	`/api/v1/health/connection-units/{id}/recovery/runs/{runId}/execute`	Выполнить подтверждённый запуск
POST	`/api/v1/health/connection-units/{id}/recovery/runs/{runId}/validate`	Проверить результат
POST	`/api/v1/health/connection-units/{id}/recovery/runs/{runId}/cancel`	Отменить запуск в допустимом состоянии

Пользовательский план не получает автоматического разрешения при сохранении: его версию нужно включить в политику Flow. Подробнее: Flow Guard, применение, транзитные пулы.

Методы Flow Studio и Flow Guard сверены с маршрутизатором текущей рабочей ветки 2026-09-06.

Telegram-прокси

Парк использует возможность Flow Studio и существующие права connection_units.*. Ссылка подключения содержит секрет, выдаётся отдельно и не кешируется.

Метод	Путь	Назначение и права
GET	`/api/v1/telegram-proxies`	Список; `connection_units.view`
GET	`/api/v1/telegram-proxies/site-templates`	Шаблоны сайта; `connection_units.view`
POST	`/api/v1/telegram-proxies/domain-check`	Проверка `node_id` и `node_domain_id`; `connection_units.view` + `nodes.view`
POST	`/api/v1/telegram-proxies`	Создать черновик; `connection_units.create`
PUT	`/api/v1/telegram-proxies/{id}`	Сохранить настройки; `connection_units.edit`
POST	`/api/v1/telegram-proxies/{id}/connection`	Получить ссылку; `connection_units.apply`
POST	`/api/v1/telegram-proxies/{id}/deploy`	Установить/применить; `connection_units.apply` + `nodes.operate`
POST	`/api/v1/telegram-proxies/{id}/check`	Проверить runtime; те же права
POST	`/api/v1/telegram-proxies/{id}/stop`	Остановить; те же права
POST	`/api/v1/telegram-proxies/{id}/remove`	Очистить и удалить; `connection_units.delete` + `nodes.operate`

Сохранение черновика не запускает установку. Ссылка соответствует последней успешно установленной конфигурации: инструкция.

Ноды и агенты

Методы управления нодами и агентами вызываются с сессией администратора. Методы /agent/v1/* — исключение: их вызывает сам агент ноды своим токеном.

Метод	Путь	Доступ	Назначение
GET/POST	`/api/v1/nodes`	Сессия	Список / создать ноду (создание запускает установку)
GET/PATCH/DELETE	`/api/v1/nodes/{id}`	Сессия	Чтение / частичное обновление / удаление (`409` при связях со схемами)
POST	`/api/v1/nodes/{id}/preflight`	Сессия	Проверка доступности и аутентификации по SSH
POST	`/api/v1/nodes/{id}/install`	Сессия	Запустить установку
GET	`/api/v1/nodes/{id}/operations`	Сессия	Лог операций ноды
GET/POST	`/api/v1/nodes/{id}/events`	Сессия	Операционный журнал ноды (POST — телеметрия UI, секреты вычищаются)
GET	`/api/v1/nodes/{id}/agent`	Сессия	Запись агента ноды (или пусто)
POST	`/api/v1/nodes/{id}/agent/enrollment-token`	Сессия	Выпустить одноразовый токен привязки (TTL 30 минут)
GET/DELETE	`/api/v1/nodes/{id}/agent/enrollment-tokens/{token_id}`	Сессия	Список / отзыв токенов привязки
POST	`/api/v1/nodes/{id}/agent/ssh-check`	Сессия	Разовая SSH-проверка пригодности
POST	`/api/v1/nodes/{id}/agent/ssh-install`	Сессия	Установка агента по SSH (поток SSE)
GET	`/api/v1/nodes/{id}/agent/metrics`	Сессия	Временной ряд метрик (`?since=`)
GET	`/api/v1/nodes/{id}/agent/services`	Сессия	Снимок статусов служб (`?refresh=1`)
GET/POST	`/api/v1/nodes/{id}/agent/tasks`	Сессия	Список / постановка задачи из белого списка
POST	`/api/v1/nodes/{id}/agent/tasks/sync`	Сессия	Синхронное выполнение (отдельный, более узкий белый список)
POST	`/api/v1/nodes/{id}/agent/update`	Сессия	Поставить задание самообновления агента (`409`, если уже на версии)
GET	`/api/v1/nodes/{id}/agent/update-jobs`	Сессия	История заданий обновления агента
GET	`/api/v1/agent/releases/latest`	Сессия	Метаданные последнего релиза агента
POST	`/api/v1/agent/releases/refresh`	Сессия	Принудительно перечитать релиз
GET/PUT	`/api/v1/agent/update-config`	Сессия	Источник обновлений агента (токен скрыт)
GET	`/install/axottle-agent.sh`	Публичный	Скрипт установки агента
GET	`/install/axottle-agent-linux-{arch}`	Публичный	Готовый бинарник агента (amd64/arm64)
GET	`/install/agent/{version}/{filename}`	Публичный	Проверенный по SHA-256 кэш бинарника
POST	`/agent/v1/enroll`	Публичный (одноразовый токен)	Привязка агента
POST	`/agent/v1/heartbeat`	Токен агента	Живость и метаданные хоста
POST	`/agent/v1/metrics`	Токен агента	Приём метрик
POST	`/agent/v1/services`	Токен агента	Приём статусов служб
GET	`/agent/v1/tasks/poll`	Токен агента	Взять задачу (`204`, если задач нет)
POST	`/agent/v1/tasks/{id}/result`	Токен агента	Отправить результат задачи
GET	`/agent/v1/qos-overrides`	Токен агента	Активные ограничения скорости
POST	`/agent/v1/abuse-signals`	Токен агента	Локально замеченный сигнал абьюза
POST	`/agent/v1/session-diversity`	Токен агента	Снимки разнообразия сессий

Подробнее: Ноды, Привязка агента.

Домены ноды

Метод	Путь	Назначение и права
GET	`/api/v1/nodes/{id}/domains`	Список; `nodes.view`
POST	`/api/v1/nodes/{id}/domains`	Добавить; `nodes.edit`
PUT	`/api/v1/nodes/{id}/domains/{domainID}`	Изменить или назначить основным; `nodes.edit`
DELETE	`/api/v1/nodes/{id}/domains/{domainID}`	Удалить неиспользуемую неосновную привязку; `nodes.edit`
POST	`/api/v1/nodes/{id}/domains/{domainID}/check`	Проверить DNS; `nodes.view`
POST	`/api/v1/nodes/{id}/domains/{domainID}/dns`	AutoDNS; `nodes.operate` и соответствующая возможность лицензии
POST	`/api/v1/nodes/{id}/domains/{domainID}/certificate/issue`	Выпустить сертификат; `nodes.operate`
POST	`/api/v1/nodes/{id}/domains/{domainID}/certificate/inspect`	Проверить сертификат; `nodes.operate`

Вход Flow выбирает привязку через node_domain_id. Производное имя домена разрешается сервером; чужая привязка отклоняется.

CDN и DNS

Метод	Путь	Доступ	Назначение
GET	`/api/v1/cdn-providers`	Сессия	Провайдеры + схема полей учётных данных и признак автоматизации
GET/POST	`/api/v1/cdn-provider-accounts`	Сессия	Список / подключить аккаунт провайдера
GET/PATCH/DELETE	`/api/v1/cdn-provider-accounts/{id}`	Сессия	Чтение / изменение / удаление аккаунта (`409`, если используется)
POST	`/api/v1/cdn-provider-accounts/{id}/revalidate`	Сессия	Повторно проверить учётные данные
GET/POST	`/api/v1/admin/cdn/dns-connections`	Сессия	DNS-подключения для CDN
GET/POST/PATCH	`/api/v1/admin/cdn/domain-pools`	Сессия	Пулы доменов доставки
GET/POST/PATCH	`/api/v1/admin/cdn/automation-policies`	Сессия	Политики автоматизации CDN
GET	`/api/v1/cdn/operations/{id}`	Сессия	Статус, план и шаг операции CDN
POST	`/api/v1/cdn/operations/{id}/rollback`	Сессия	Откат операции (для READY запрещён — `409`)
GET	`/api/v1/cdn/resources`	Сессия	Список созданных ресурсов CDN
GET/PUT	`/api/v1/integrations/cloudflare`	Сессия	Список / создание привязки зоны Cloudflare (AutoDNS; токен только для записи)
DELETE	`/api/v1/integrations/cloudflare/{id}`	Сессия	Удалить привязку (существующие DNS-записи остаются)
POST	`/api/v1/integrations/cloudflare/{id}/test`	Сессия	Проверить токен, доступ к зоне и права DNS

Само провизионирование CDN выполняется внутри POST /api/v1/connection-units/{id}/apply — отдельного метода у него нет. Подробнее: CDN, DNS.

Одноразовая настройка Cloudflare

POST /api/v1/setup/cloudflare/dns требует сессию и settings.manage. Поля: domain, server_ip, токен только для записи api_token, необязательное save_integration (по умолчанию false). Результат содержит root_domain, created, при сохранении — интеграцию без токена; save_error может сообщить об ошибке сохранения уже после успешной записи DNS. Не повторяйте изменение вслепую: сначала проверьте результат.

Здоровье и self-heal

Метод	Путь	Доступ	Назначение
GET	`/api/v1/health/summary`	Сессия	Карточки дашборда + скрытое подавлением
GET	`/api/v1/health/dashboard`	Сессия	Сводка, таблицы и инциденты одним ответом
GET	`/api/v1/health/nodes`	Сессия	Таблица нод (фильтры: статус, страна, провайдер)
GET	`/api/v1/health/connection-units`	Сессия	Таблица схем подключения
GET	`/api/v1/health/routes`	Сессия	Таблица маршрутов
GET	`/api/v1/health/incidents`	Сессия	Лента инцидентов (`since`, `limit`, `include_suppressed`)
POST	`/api/v1/health/recheck`	Сессия	Перепроверить все применённые Flow
GET/PUT	`/api/v1/health/settings`	Сессия	Политика мониторинга (интервалы, каналы, ИИ-триггер)
GET	`/api/v1/health/connection-units/{id}`	Сессия	Кэш-сводка по схеме
POST	`/api/v1/health/connection-units/{id}/check`	Сессия	Свежая полная проверка (одна попытка дозвона)
GET	`/api/v1/health/connection-units/{id}/probes`	Сессия	История проб (≤ 500)
GET	`/api/v1/health/connection-units/{id}/diagnostics`	Сессия	Диагностический пакет доказательств
POST	`/api/v1/health/connection-units/{id}/diagnostics/logs`	Сессия	Сбор логов нод (обрезаны и отредактированы)
GET	`/api/v1/health/connection-units/{id}/dependency-tree`	Сессия	Дерево зависимостей схемы
GET/POST	`/api/v1/health/connection-units/{id}/entry-blocks/{blockId}/external-probe`	Сессия	Внешние региональные пробы L5
GET/POST	`/api/v1/health/nodes/{id}`	Сессия	Сводка ноды / запуск проверки
GET	`/api/v1/health/nodes/{id}/probes`	Сессия	История проб ноды
GET/PUT/DELETE	`/api/v1/health/external-providers`	Сессия	Реестр внешних провайдеров L5 и их методы
POST	`/api/v1/nodes/status-refresh`	Сессия	Обновить снимок Remnawave + проверка здоровья по всему парку
POST	`/api/v1/nodes/{id}/status-refresh`	Сессия	То же для одной ноды
GET/POST/DELETE	`/api/v1/nodes/{id}/suppression`	Сессия	Просмотр / создать-заменить / снять «заглушку» ноды

Подробнее: Здоровье, Self-heal.

История Bscheck

GET /api/v1/health/connection-units/{id}/bscheck-reports возвращает сохранённые внешние отчёты Flow (до 100). Это чтение истории, не запуск платной проверки. Интерпретация результата и его свежести: Bscheck.

Обновление Statuspage

Метод	Путь	Назначение
GET	`/api/v1/statuspage/instances/{instanceID}/update`	Проверить версии приложения страницы
POST	`/api/v1/statuspage/instances/{instanceID}/update/command`	Получить команду для выбранной `version`; само обновление не запускает
POST	`/api/v1/statuspage/instances/{instanceID}/update/ssh`	Обновить существующий сервер по SSH

Чтение требует statuspage.view, изменяющие методы — также statuspage.deploy. Проверяйте запущенную версию и enrollment после операции: обновления Statuspage.

Remnawave

Метод	Путь	Доступ	Назначение
POST	`/api/v1/remnawave/test`	Сессия	Проверить URL и токен без сохранения
GET/POST	`/api/v1/remnawave/connections`	Сессия	Список / создать подключение к панели
GET	`/api/v1/remnawave/connections/{id}`	Сессия	Одно подключение
POST	`/api/v1/remnawave/connections/{id}/test`	Сессия	Проверить сохранённое подключение (обновляет статус)
POST	`/api/v1/remnawave/connections/{id}/sync`	Сессия	Синхронизировать локальные снимки (вручную)
DELETE	`/api/v1/remnawave/connections/{id}`	Сессия	Удалить подключение и его снимки
GET	`/api/v1/remnawave/connections/{id}/diagnostics`	Сессия	Живая диагностика панели
GET	`/api/v1/remnawave/users`	Сессия	Локальный снимок пользователей
GET	`/api/v1/remnawave/nodes`	Сессия	Локальный снимок нод
GET	`/api/v1/remnawave/hosts`	Сессия	Локальный снимок хостов
GET	`/api/v1/remnawave/config-profiles`	Сессия	Локальный снимок конфиг-профилей
GET	`/api/v1/remnawave/internal-squads`	Сессия	Живой список сквадов панели
GET/POST	`/api/v1/remnawave/connections/{id}/backup-profiles`	Сессия + лицензия	Профили резервных копий БД Remnawave
GET/PATCH/DELETE	`/api/v1/remnawave/backup-profiles/{profileId}`	Сессия + лицензия	Управление профилем копий
POST	`/api/v1/remnawave/backup-profiles/{profileId}/test`	Сессия + лицензия	Проверить доступ к цели резервного копирования
GET/POST	`/api/v1/remnawave/backup-profiles/{profileId}/backups`	Сессия + лицензия	Список / запуск копий
GET	`/api/v1/remnawave/backups/{backupId}`	Сессия + лицензия	Запись прогона копии
POST	`/api/v1/remnawave/backups/{backupId}/verify`	Сессия + лицензия	Проверка целостности
GET	`/api/v1/remnawave/backups/{backupId}/restore-plan`	Сессия + лицензия	Предпросмотр восстановления
POST	`/api/v1/remnawave/backups/{backupId}/restore`	Сессия + лицензия	Восстановление (требует `confirm: true`)
DELETE	`/api/v1/remnawave/backups/{backupId}`	Сессия + лицензия	Удалить запись копии

Подробнее: Remnawave.

AbuseProtect

Метод	Путь	Доступ	Назначение
GET	`/api/v1/abuse/summary`	Сессия	Сводка дашборда абьюза
GET/POST	`/api/v1/abuse/incidents`	Сессия	Список / ручное открытие инцидента
GET	`/api/v1/abuse/incidents/{id}`	Сессия	Инцидент с сигналами, таймлайном, ограничениями
POST	`/api/v1/abuse/incidents/{id}/event`	Сессия	Добавить заметку или сменить статус
POST	`/api/v1/abuse/incidents/{id}/close`	Сессия	Закрыть как `resolved` или `false_positive` (нужна причина)
POST	`/api/v1/abuse/incidents/{id}/status`	Сессия	Переход статуса
POST	`/api/v1/abuse/incidents/{id}/evidence`	Сессия	Собрать и прикрепить доказательства
GET/POST	`/api/v1/abuse/qos-overrides`	Сессия	Список / применить временное замедление
DELETE	`/api/v1/abuse/qos-overrides/{id}`	Сессия	Снять замедление вручную
GET	`/api/v1/abuse/service-identities`	Сессия	Защищённые инфраструктурные аккаунты
GET	`/api/v1/abuse/signals`	Сессия	Сырые сигналы детекторов
POST	`/api/v1/abuse/detect`	Сессия	Запустить один проход детекции сейчас
GET/PUT	`/api/v1/abuse/policy`	Сессия	Чтение / сохранение политики
GET/PUT	`/api/v1/abuse/telegram`	Сессия	Маршрутизация Telegram (токен маскирован)
POST	`/api/v1/abuse/telegram/test`	Сессия	Отправить тестовое уведомление
GET	`/api/v1/abuse/apply-status`	Сессия	Бейдж «применено/отсутствует» по ноде (`?node=`)
GET	`/api/v1/abuse/user-profile`	Сессия	Профиль абьюза по пользователю (`?user=`)

Агент дополнительно поставляет телеметрию через POST /agent/v1/abuse-signals и POST /agent/v1/session-diversity (см. раздел «Ноды и агенты»). Подробнее: AbuseProtect.

Axosun — ассистент

Метод	Путь	Доступ	Назначение
—	Управление ассистентом — через панель	Сессия	Раздел Axosun в панели: профили, политика, каталог действий, сессии, история

Прямые пути API ассистента здесь намеренно не публикуются: они содержат внутреннее имя, которое мы не раскрываем в публичной документации. Управляйте ассистентом через раздел Axosun в панели. Возможности, права и порядок подтверждения действий описаны отдельно.

Подробнее: Axosun.

Безопасность

Метод	Путь	Доступ	Назначение
GET/POST	`/api/v1/security-profiles`	Сессия	Список / создать профиль безопасности
GET	`/api/v1/security-profiles/{id}`	Сессия	Получить профиль
GET/POST	`/api/v1/nodes/{id}/security-services/compliance`	Сессия	Чтение / запуск проверки соответствия (CrowdSec, Fail2Ban, UFW)
GET	`/api/v1/security/detectors/status`	Сессия	Статус детекторов по всем нодам
GET	`/api/v1/security/detectors/status/{nodeId}`	Сессия	Статус детекторов одной ноды
GET	`/api/v1/security/dangerous-ports/catalog`	Сессия	Фиксированный каталог опасных портов
GET/PUT	`/api/v1/security/egress`	Сессия	Чтение / сохранение политики egress («сохранено» ≠ «применено»)
GET	`/api/v1/security/egress/status`	Сессия	Желаемое vs применённое по нодам
POST	`/api/v1/security/egress/reconcile`	Сессия	Повторно применить желаемое состояние
GET	`/api/v1/decoy/templates`	Сессия	Каталог шаблонов маскировочных сайтов
GET/POST	`/api/v1/decoy/templates/{id}/preview`	Сессия	Предпросмотр шаблона в песочнице
GET/POST	`/api/v1/decoy/deployments`	Сессия	Список / создать развёртывание маскировки
GET/PATCH/DELETE	`/api/v1/decoy/deployments/{id}`	Сессия	Управление развёртыванием
POST	`/api/v1/decoy/deployments/{id}/install` · `/verify` · `/remove`	Сессия	Действия агента: `202` + `task_id`
GET/POST/PATCH/DELETE	`/api/v1/nodes/{id}/selfsteal`	Сессия	Маскировочный сайт (selfsteal) на ноде: статус, включение, деплой, проверка
GET	`/api/v1/audit-log`	Сессия	Журнал аудита (`limit` ≤ 500, `offset`, фильтр `q`)

Подробнее: Безопасность, Аудит и соответствие.

Операционные разделы

Резервные копии, лицензия, уведомления, гео-ассеты и провайдеры. Все методы ниже — с доступом «Сессия», если не указано иное.

Резервные копии панели

Метод	Путь	Доступ	Назначение
POST/GET	`/api/v1/backups/profiles`	Сессия	Создать / список профилей резервных копий
GET/PATCH/DELETE	`/api/v1/backups/profiles/{id}`	Сессия	Управление профилем
POST	`/api/v1/backups/profiles/{id}/test`	Сессия	Проверить цель хранения (локально/S3)
POST/GET	`/api/v1/backups/runs`	Сессия	Запустить сейчас / список прогонов
GET	`/api/v1/backups/runs/{id}`	Сессия	Детали прогона
POST	`/api/v1/backups/runs/{id}/verify`	Сессия	Проверка целостности (SHA-256)
GET	`/api/v1/backups/runs/{id}/restore-preview`	Сессия	Предпросмотр восстановления
POST	`/api/v1/backups/runs/{id}/restore`	Сессия	Восстановление (требует `confirm: true`, разрушающая операция)

Подробнее: Резервные копии.

Лицензия

Метод	Путь	Доступ	Назначение
GET	`/api/v1/license/status`	Сессия	Статус лицензии (ключ маскирован) + использование
GET	`/api/v1/license/summary`	Сессия	Текстовая сводка для обращения в поддержку
GET	`/api/v1/license/features`	Сессия	Плоская карта «функция → включена»
POST	`/api/v1/license/activate`	Сессия	Активировать ключ
POST	`/api/v1/license/refresh`	Сессия	Принудительно перепроверить (может включить льготный период)
POST	`/api/v1/license/remove`	Сессия	Деактивировать установку

Подробнее: Лицензия.

Уведомления

Метод	Путь	Доступ	Назначение
GET/PUT	`/api/v1/notifications/telegram`	Сессия	Маршрутизация + каталог категорий (токен маскирован)
POST	`/api/v1/notifications/telegram/test`	Сессия	Отправить тестовое сообщение (реальная ошибка возвращается)
GET	`/api/v1/notifications/telegram/helper/session`	Сессия	SSE-сессия бота-помощника (получить chat id / topic id)
POST	`/api/v1/notifications/telegram/helper/stop`	Сессия	Остановить сессию помощника

Подробнее: Уведомления.

Гео-ассеты

Метод	Путь	Доступ	Назначение
GET/POST	`/api/v1/geo-assets/files`	Сессия	Список / загрузка гео-файлов
DELETE	`/api/v1/geo-assets/files/{id}`	Сессия	Удалить файл
GET/POST	`/api/v1/geo-assets/profiles`	Сессия	Список / создать профиль
GET/DELETE	`/api/v1/geo-assets/profiles/{id}`	Сессия	Чтение / удаление профиля
GET/POST	`/api/v1/geo-assets/profiles/{id}/sets`	Сессия	GeoSet-карточки профиля
GET/PATCH/PUT/DELETE	`/api/v1/geo-assets/profiles/{id}/sets/{set_id}`	Сессия	Управление GeoSet
POST	`/api/v1/geo-assets/sets/{set_id}/validate`	Сессия	Проверить (пере-хешировать/скачать) набор
POST	`/api/v1/geo-assets/profiles/{id}/validate`	Сессия	Проверить весь профиль
POST	`/api/v1/geo-assets/profiles/{id}/assign-bulk`	Сессия	Массовое назначение профиля нодам
POST/DELETE	`/api/v1/nodes/{node_id}/geo-asset-assignment`	Сессия	Назначить / снять профиль с ноды
GET	`/api/v1/nodes/{node_id}/geo-asset-state`	Сессия	Состояние гео-файлов на ноде (по хешам)
POST	`/api/v1/nodes/{node_id}/geo-asset-sync`	Сессия	Синхронизировать гео-данные на ноду
GET/POST	`/api/v1/nodes/{node_id}/geo-asset-rollback`	Сессия	Наличие снимка / откат к предыдущему набору
GET	`/install/geo/{id}`	Публичный	Отдача гео-файла агенту (безопасность — проверка SHA-256 на ноде)

Подробнее: Гео-ассеты.

Провайдеры хостинга

Метод	Путь	Доступ	Назначение
GET/POST	`/api/v1/providers/bundles`	Сессия	Список / установка адаптеров провайдеров (манифест)
GET/DELETE	`/api/v1/providers/bundles/{id}`	Сессия	Чтение / удаление адаптера
GET/POST	`/api/v1/providers/accounts`	Сессия	Список / создание аккаунта провайдера
DELETE	`/api/v1/providers/accounts/{id}`	Сессия	Удалить аккаунт
POST	`/api/v1/providers/accounts/{id}/test`	Сессия	Проверить учётные данные
GET	`/api/v1/providers/accounts/{id}/regions`	Сессия	Живой список регионов
GET	`/api/v1/providers/accounts/{id}/plans`	Сессия	Живой список тарифов

Экрана для этих ручек в панели сейчас нет: создание серверов через API провайдера ещё не доведено до конца и убрано из меню. Сами эндпоинты работают и требуют ключа core.cloud_providers.

Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.

Дополнение по изменениям кода Axottle: 2026-09-08. Новые сценарии сверены с реализацией; установка на реальные ноды в рамках этой сверки не выполнялась.

​Как читать таблицы

​Аутентификация и сессии

​Учётные записи и права

​Система и статус

​Flow (Конфиги)

​Поиск и проверка целей REALITY

​Применение просмотренного плана

​Транзитные пулы и политики

​Здоровье и Flow Guard

​Telegram-прокси

​Ноды и агенты

​Домены ноды

​CDN и DNS

​Одноразовая настройка Cloudflare

​Здоровье и self-heal

​История Bscheck

​Обновление Statuspage

​Remnawave

​AbuseProtect

​Axosun — ассистент

​Безопасность

​Операционные разделы

​Резервные копии панели

​Лицензия

​Уведомления

​Гео-ассеты

​Провайдеры хостинга

Как читать таблицы

Аутентификация и сессии

Учётные записи и права

Система и статус

Flow (Конфиги)

Поиск и проверка целей REALITY

Применение просмотренного плана

Транзитные пулы и политики

Здоровье и Flow Guard

Telegram-прокси

Ноды и агенты

Домены ноды

CDN и DNS

Одноразовая настройка Cloudflare

Здоровье и self-heal

История Bscheck

Обновление Statuspage

Remnawave

AbuseProtect

Axosun — ассистент

Безопасность

Операционные разделы

Резервные копии панели

Лицензия

Уведомления

Гео-ассеты

Провайдеры хостинга