> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axottle.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Основные методы API Axottle по разделам: путь, метод, доступ и назначение.

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

<Info>
  Для кого: разработчик, интегрирующийся с Axottle; администратор, автоматизирующий рутину.
  Требуемые права: действующая сессия администратора для методов с доступом «Сессия». Начните с [Обзора API](/ru/api-reference/overview), [Аутентификации](/ru/api-reference/authentication) и [Соглашений](/ru/api-reference/conventions).
</Info>

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

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

* **Базовый адрес.** Все пути с префиксом `/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`).

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

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

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

| Метод | Путь                                | Доступ                                 | Назначение                                                                      |
| ----- | ----------------------------------- | -------------------------------------- | ------------------------------------------------------------------------------- |
| POST  | `/api/v1/auth/login`                | Публичный                              | Вход по `{username, password}`; возвращает токен сессии и срок действия         |
| POST  | `/api/v1/auth/logout`               | Сессия                                 | Завершить текущую сессию (работает и в режиме «только чтение»)                  |
| GET   | `/api/v1/auth/me`                   | Сессия                                 | Текущий администратор: id, имя, роль                                            |
| 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/*` доступны только во время первичной установки; создание администратора отклоняется после появления первого администратора.

Подробнее: [Аутентификация](/ru/api-reference/authentication), [Доступ и сессии](/ru/panel/access-and-sessions).

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

| Метод   | Путь                           | Доступ    | Назначение                                             |
| ------- | ------------------------------ | --------- | ------------------------------------------------------ |
| 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` | Сессия    | Состояние обновления, восстановленное с диска          |

Подробнее: [Обновления панели](/ru/operations/updates).

## Connection Units

| Метод            | Путь                                                 | Доступ | Назначение                                                                |
| ---------------- | ---------------------------------------------------- | ------ | ------------------------------------------------------------------------- |
| GET/POST         | `/api/v1/connection-units`                           | Сессия | Список / создать схему подключения                                        |
| GET              | `/api/v1/connection-units/node-occupancies`          | Сессия | Карта «нода → использующие её Connection Units»                           |
| GET/PATCH/DELETE | `/api/v1/connection-units/{id}`                      | Сессия | Чтение / изменение / удаление схемы (удаление чистит управляемые ресурсы) |
| GET              | `/api/v1/connection-units/{id}/delete-preview`       | Сессия | Что именно удалит удаление                                                |
| GET/PUT          | `/api/v1/connection-units/{id}/graph`                | Сессия | Чтение / сохранение черновика холста                                      |
| POST             | `/api/v1/connection-units/{id}/autosave`             | Сессия | Автосохранение холста                                                     |
| POST             | `/api/v1/connection-units/{id}/discard-draft`        | Сессия | Сбросить черновик до применённого снимка                                  |
| GET              | `/api/v1/connection-units/{id}/versions`             | Сессия | История версий                                                            |
| GET              | `/api/v1/connection-units/{id}/versions/{versionId}` | Сессия | Снимок одной версии (для отката)                                          |
| POST             | `/api/v1/connection-units/{id}/compile`              | Сессия | Скомпилировать черновик в план                                            |
| GET              | `/api/v1/connection-units/{id}/compile-plan`         | Сессия | Последний план компиляции                                                 |
| POST             | `/api/v1/connection-units/{id}/lint`                 | Сессия | Статический аудит конфигурации                                            |
| POST             | `/api/v1/connection-units/{id}/preflight`            | Сессия | Линтер + план компиляции одним ответом                                    |
| POST             | `/api/v1/connection-units/{id}/apply`                | Сессия | Применить план (развернуть)                                               |

Подробнее: [Connection Units](/ru/connection-units/overview).

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

Методы управления нодами и агентами вызываются с сессией администратора. Методы `/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`                           | Токен агента                  | Снимки разнообразия сессий                                             |

Подробнее: [Ноды](/ru/nodes/overview), [Привязка агента](/ru/nodes/enrollment).

## 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](/ru/cdn/overview), [DNS](/ru/cdn/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`                                                     | Сессия | Перепроверить все применённые Connection Units               |
| 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`                                             | Сессия | Просмотр / создать-заменить / снять «заглушку» ноды          |

Подробнее: [Здоровье](/ru/health/overview), [Self-heal](/ru/health/self-heal).

## 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](/ru/remnawave/overview).

## Защита от абьюза

| Метод    | Путь                                    | Доступ | Назначение                                                  |
| -------- | --------------------------------------- | ------ | ----------------------------------------------------------- |
| 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` (см. раздел «Ноды и агенты»).

Подробнее: [Защита от абьюза](/ru/abuse/overview).

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

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

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

Подробнее: [Axosun](/ru/axosun/overview).

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

| Метод                 | Путь                                                             | Доступ | Назначение                                                                  |
| --------------------- | ---------------------------------------------------------------- | ------ | --------------------------------------------------------------------------- |
| 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`)                         |

Подробнее: [Безопасность](/ru/security/overview), [Аудит и соответствие](/ru/security/audit-and-compliance).

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

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

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

| Метод            | Путь                                        | Доступ | Назначение                                                     |
| ---------------- | ------------------------------------------- | ------ | -------------------------------------------------------------- |
| 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`, разрушающая операция) |

Подробнее: [Резервные копии](/ru/operations/backups).

### Лицензия

| Метод | Путь                       | Доступ | Назначение                                                   |
| ----- | -------------------------- | ------ | ------------------------------------------------------------ |
| 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`   | Сессия | Деактивировать установку                                     |

Подробнее: [Лицензия](/ru/operations/license).

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

| Метод   | Путь                                            | Доступ | Назначение                                                  |
| ------- | ----------------------------------------------- | ------ | ----------------------------------------------------------- |
| 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`    | Сессия | Остановить сессию помощника                                 |

Подробнее: [Уведомления](/ru/panel/notifications).

### Гео-ассеты

| Метод                | Путь                                             | Доступ    | Назначение                                                        |
| -------------------- | ------------------------------------------------ | --------- | ----------------------------------------------------------------- |
| 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 на ноде) |

Подробнее: [Гео-ассеты](/ru/operations/geo-assets).

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

| Метод      | Путь                                      | Доступ | Назначение                                          |
| ---------- | ----------------------------------------- | ------ | --------------------------------------------------- |
| 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`   | Сессия | Живой список тарифов                                |

Подробнее: [Провайдеры](/ru/operations/providers).

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