Быстрый старт (≈15 минут)

Минимальный путь для интегратора: установить ядро 1.0.13, убедиться что платформа отвечает, при необходимости настроить почту и выполнить первый запрос Public Auth. Подробности — в полной инструкции по установке.

1. Установка ядра

Скачайте и установите пакет ядра — см. раздел «Установка и запуск». Пройдите мастер первичной настройки: мастер настройки.

Если обновляетесь с 1.0.12, сначала следуйте инструкции обновления.

2. Проверка health

curl http://localhost:5000/api/health

Ожидается JSON со "status":"ok" и "version":"1.0.13" (или вашей установленной версией).

3. Вход в админ-панель

1. Откройте http://localhost:5000/login.
2. Войдите под учётной записью администратора, созданной в мастере.
3. Убедитесь, что на главной панели нет критических ошибок.

4. Почта (если нужен email verify)

Для регистрации с подтверждением email настройте транспорт в Настройки → Почта и выполните test-send. Без SMTP register может вернуть 503 mail_unavailable — см. решение проблем с почтой и настройку почты.

5. Первый вызов Public Auth

Краткий контракт — авторизация пользователей. Пример регистрации и входа:

curl -X POST http://localhost:5000/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username":"demo","email":"demo@example.ru","password":"DemoPass1","consent_pd":true}'

curl -X POST http://localhost:5000/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username":"demo","password":"DemoPass1"}'

Форматы ответов и коды ошибок — в общих соглашениях.

6. Swagger и следующие шаги

• Интерактивный справочник: /api/docs/public — см. OpenAPI и метрики.
• Сводная таблица методов: сводный индекс.
• Service API (почта, данные, файлы): создайте API-ключ в админке — API-ключи.
• Медиатека (опционально): модуль 1.0.0 — установка модуля, API — медиатека файлов.