Skip to main content
Эта страница — сгруппированный по разделам справочник основных методов, с которыми работает оператор панели. Он покрывает административный 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...).

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

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

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

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

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

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

Connection Units

Подробнее: Connection Units.

Ноды и агенты

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

CDN и DNS

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

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

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

Remnawave

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

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

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

Axosun — ассистент

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

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

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

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

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

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

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

Лицензия

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

Уведомления

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

Гео-ассеты

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

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

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