/api/v1 и, за исключением публичных и setup-эндпоинтов, требуют авторизованной сессии администратора.
Для кого: администратор, SRE, разработчик интеграций. Требуемые права: зависят от эндпоинта.
Полный машинный каталог кодов ошибок в продукте пока не опубликован. Эта таблица описывает наблюдаемое поведение API: какие HTTP-статусы возвращаются, в каких ситуациях и что делать оператору. По мере стабилизации каталога страница будет расширяться.
HTTP-статусы
| Статус | Типовая причина | Действие оператора |
|---|---|---|
400 | Некорректный запрос: невалидный JSON, отсутствующие обязательные поля, неверные параметры | Проверьте тело и параметры запроса по документации соответствующего эндпоинта |
401 | Нет сессии или сессия просрочена: отсутствует/невалиден заголовок Authorization: Bearer <session-token> | Выполните вход заново (POST /api/v1/auth/login) и повторите запрос с новым токеном |
403 | Недостаточно прав или лицензионное ограничение: в деградированном режиме лицензии все изменяющие запросы отклоняются с сообщением о режиме «только чтение»; отдельные функции могут быть заблокированы планом лицензии | Проверьте статус лицензии (axottle license status или GET /api/v1/license/status). В деградированном режиме доступны поверхности восстановления: активация лицензии, самообновление панели, обновление агентов, аутентификация |
404 | Ресурс не найден: несуществующий идентификатор, удалённый объект или неверный публичный токен в публичных ссылках | Проверьте идентификатор/токен в URL; для публичных ссылок — актуальность ссылки |
409 | Конфликт состояния: операция несовместима с текущим состоянием системы | Дождитесь завершения конкурирующей операции или устраните конфликт (примеры ниже) |
422 | Ошибка валидации: данные синтаксически корректны, но не проходят бизнес-проверки | Исправьте значения полей согласно сообщению об ошибке |
5xx | Внутренняя ошибка панели или зависимого сервиса | Смотрите логи: axottle logs backend --tail 200, затем axottle doctor; при повторении соберите support-бандл |
Примеры конфликтов 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 — единственный эндпоинт уведомлений, который возвращает реальную ошибку доставки:
| Статус | Значение | Действие |
|---|---|---|
400 | Уведомления не настроены (нет токена бота или chat id) | Заполните настройки Telegram в панели |
502 | Ошибка Telegram Bot API | Проверьте корректность токена бота и права бота в чате |
504 | Таймаут обращения к Telegram | Проверьте исходящую сетевую доступность с сервера панели |
Деградированный режим лицензии
Если лицензия отсутствует, просрочена и не в grace-периоде, панель работает в режиме «только чтение»:GET-запросы проходят, изменяющие запросы получают 403. Это не сбой, а штатная защита — восстановите лицензию, и запись снова заработает. Подробнее: Лицензия.
Диагностика по шагам
Определите класс ошибки
4xx — проблема запроса, прав или состояния; 5xx — проблема на стороне панели.Связанные страницы
CLI axottle
Команды
logs, doctor, license status.Лицензия
Grace-период и деградированный режим.
Проверено для версии Axottle текущей ветки. Дата проверки: 2026-07-11.