Решение проблем

Типовые ситуации при установке, настройке и интеграции через Public API. Если шаг не помог — см. установку или обратитесь в поддержку.

Установка и мастер

Проверьте, что порт public (обычно 5000) свободен: ss -tlnp | grep 5000.
Статус unit: systemctl status cascad360; логи: journalctl -u cascad360 -n 50.
Без systemd: ./cascad360 start из каталога установки — см. systemd.

На шаге БД дождитесь успешной «Проверки соединения» перед переходом дальше.
Убедитесь, что у процесса есть права записи в каталог установки и config.yml.
После завершения в конфиге должны быть setup_completed: true и корректные параметры БД.
Вход в панель — http://localhost:5000/login, не на порту мастера.

Если мастер завис на нестандартном шаге — зафиксируйте сообщение на экране и обратитесь в поддержку (скриншот + фрагмент лога без паролей).

Почтовый контур не готов. Платформа может работать в режиме degraded без SMTP.

Откройте Настройки → Почта, настройте transport (рекомендуется SMTP для production).
Выполните «Отправить тест».
Повторите register или временно отключите обязательный verify email в настройках Public Auth (если политика организации позволяет).

Симптом / код	Что проверить
`registration_disabled`	Включена ли регистрация в Настройки → Public Auth.
`consent_required`	Передайте `consent_pd: true` и при необходимости `consent_version` в register.
`validation_error`	Длина пароля (min 8), формат email, уникальность username/email.
Lockout после login	Параметры lockout в Public Auth; подождите окно блокировки или разблокируйте пользователя в админке.
Ссылка confirm email не работает	Базовый URL подтверждения email должен указывать на ваш фронт (`https://…/auth/confirm-email`).

401 / 403 — проверьте заголовок X-API-Key или JWT; у service-ключа должны быть нужные permission (mail:send, db:query, …).
Database API — с 1.0.10 источник данных задаётся привязкой service-ключа к сервису и whitelist таблиц; не передавайте database / datasource_id в теле запроса.
public key для фронта — в системных настройках при режиме api_key_required.

В production используйте HTTPS для base URL.
Public Auth и большинство методов ядра возвращают формат A (success + data); Mail/Database — формат B. См. форматы ответов.
Ошибки CORS настраиваются на стороне платформы и вашего фронта — origin должен быть разрешён политикой вашего деплоя.
Актуальный контракт — GET /api/openapi.json и Swagger UI.

Files API доступен только при установленном модуле «Медиатека файлов» 1.0.0 и ядре ≥ 1.0.13.
В config.yml: files.enabled: true, модуль в modules.installed.
404 на /media/… — проверьте nginx/прокси и права на файл; см. медиатека файлов и установку модуля.

Обновление версий: инструкции по обновлению. Быстрая проверка после установки: чеклист verify.