Troubleshooting

Troubleshooting

Swagger не открывается

1. Убедитесь, что API запущен.
2. Проверьте правильный порт в настройках API.
3. Проверьте GET /health.
4. Откройте http://127.0.0.1:<port>/api/docs.

401 Unauthorized

Передайте X-API-Key.

404 not_found для config

Используйте versioned путь:

/api/v1/config

Legacy /api/config не является основным контрактом.

Ошибки валидации schedule

Поля зависят от trigger:

• once -> datetime
• daily -> time
• weekly -> time, day_of_week
• interval -> hours/minutes
• cron -> cron_expression

Ошибки FFmpeg

• Проверьте ffmpeg -version
• Убедитесь, что путь записи доступен
• Смотрите logs/ и logs/api/

/health работает, а другие эндпоинты нет

Обычно это одна из причин:

• не передан X-API-Key;
• используется legacy путь вместо /api/v1/*;
• порт в запросе не совпадает с портом сервера.

Сервер слушает не тот порт

• Порт меняется во вкладке API.
• После смены порта нажмите Перезапустить.
• Проверяйте запросы и Swagger на новом порту.

.env или .venv «не работает»

• .venv надо активировать в текущей сессии PowerShell: .venv\Scripts\Activate.ps1
• .env читается при старте main.py.
• Для API токена предпочтительно использовать MIA_API_KEY.

Таймаут при POST /api/v1/stop

Если GUI-поток занят, остановка может завершиться таймаутом. Проверьте:

• нет ли зависания окна GUI;
• что запись действительно стартовала и FFmpeg процесс активен;
• последние строки в logs/mia_*.log и logs/api/api_*.log.