Быстрый старт

Зарегистрируйте школу, подтвердите email, создайте управляемый сеанс и сделайте первый авторизованный запрос за несколько минут.

Шаг 1. Зарегистрируйте школу

Регистрация создаёт школу (тенант), её администратора и пробный период. Школа остаётся в статусе pending до перехода по одноразовой ссылке из письма.

cURL

curl -X POST https://api.edumentor.kz/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "tenant_title": "Acme School",
    "tenant_slug": "acme",
    "email": "admin@acme.kz",
    "password": "super-secret",
    "first_name": "Айгерим",
    "last_name": "Нурлан"
  }'

Ответ

{
  "success": true,
  "data": {
    "verification_required": true,
    "email": "admin@acme.kz",
    "verification_expires_at": "2026-07-23T10:00:00Z"
  }
}

Шаг 2. Подтвердите email

Откройте ссылку из письма. Клиент передаст одноразовый токен в POST /auth/verify-email и активирует школу. Затем выполните POST /auth/login со стабильным installation_id: браузер получит access JWT и защищённую HttpOnly refresh-cookie.

Шаг 3. Сделайте авторизованный запрос

Запросы к школе требуют двух заголовков: Authorization с токеном и X-Tenant-Subdomain с субдоменом школы. Создадим первый курс.

cURL

curl -X POST https://api.edumentor.kz/api/v1/t/courses \
  -H "Authorization: Bearer <token>" \
  -H "X-Tenant-Subdomain: acme" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Введение в Python", "slug": "python-intro" }'

Готово

Вы создали школу и первый курс. Дальше изучите Роли и доступы, чтобы понять, какие эндпоинты доступны администратору, куратору и ученику, и переходите к Справочнику API.

Демо-контент

После регистрации школа уже содержит демо-курс и тест — кабинет не будет пустым, можно сразу осмотреться.

НазадAPI EduMentor Далее Аутентификация