/api/v1 и, за исключением публичных и setup-эндпоинтов, требуют авторизованной сессии администратора.
Для кого: администратор, SRE, разработчик интеграций. Требуемые права: зависят от эндпоинта.
Полный машинный каталог кодов ошибок в продукте пока не опубликован. Эта таблица описывает наблюдаемое поведение API: какие HTTP-статусы возвращаются, в каких ситуациях и что делать оператору. По мере стабилизации каталога страница будет расширяться.
HTTP-статусы
Примеры конфликтов 409
- Бэкап уже выполняется — по каждому профилю одновременно идёт не более одного запуска; повторный
POST /api/v1/backups/runsдля того же профиля вернёт409. Дождитесь завершения текущего запуска. - Автопривязка Remnawave отключена —
POST /api/v1/setup/remnawave/bootstrapвозвращает409, если переменнаяAXOTTLE_RW_BOOTSTRAPне включена. - Вторая сессия Telegram-помощника — helper-сессия для настройки уведомлений одиночная; параллельная попытка открыть вторую получает
409.
Особые случаи
Тест Telegram-уведомлений
POST /api/v1/notifications/telegram/test — единственный эндпоинт уведомлений, который возвращает реальную ошибку доставки:
В остальных случаях доставка уведомлений — best-effort: сбой отправки не ломает вызвавшую его операцию, ошибка фиксируется в audit-журнале.
Деградированный режим лицензии
Если лицензия отсутствует, просрочена и не в grace-периоде, панель работает в режиме «только чтение»:GET-запросы проходят, изменяющие запросы получают 403. Это не сбой, а штатная защита — восстановите лицензию, и запись снова заработает. Подробнее: Лицензия.
Диагностика по шагам
1
Определите класс ошибки
4xx — проблема запроса, прав или состояния; 5xx — проблема на стороне панели.2
Для 401/403 проверьте сессию и лицензию
3
Для 5xx смотрите логи и Doctor
Связанные страницы
CLI axottle
Команды
logs, doctor, license status.Лицензия
Grace-период и деградированный режим.
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.