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

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

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

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

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": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "user": { "id": "8f3b1c2a-...", "email": "admin@acme.kz", "role": "admin" }
  }
}

Шаг 2. Сохраните токен

Токен из поля data.token передаётся в заголовке Authorization во всех последующих запросах. Подробнее — в разделе Аутентификация.

Шаг 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 Далее Аутентификация