LatornLatorn
Войти

Помощь · Интеграции

Документация API

Публичные маршруты Latorn для учётных записей, обучения и преподавательских инструментов. Каждый раздел можно читать отдельно.

В кабинетПроверить API
Здесь описаны только пользовательские и преподавательские интеграции. Служебные операции платформы в публичный справочник не входят.

Справочник API

Инструменты репетитора

Личные карточки учащихся, расписание, ручной финансовый журнал и переиспользуемый банк заданий.

Маршруты раздела

Метод Маршрут Доступ Назначение
GET /api/instructor/tutor/students Преподаватель Получить личные карточки учащихся.
POST /api/instructor/tutor/students Преподаватель Создать карточку учащегося.
PATCH /api/instructor/tutor/students/[id] Владелец карточки Изменить или архивировать карточку.
DELETE /api/instructor/tutor/students/[id] Владелец карточки Удалить пустую карточку без истории.
GET /api/instructor/tutor/appointments Преподаватель Получить занятия за период.
POST /api/instructor/tutor/appointments Преподаватель Создать индивидуальное или групповое занятие.
PATCH /api/instructor/tutor/appointments/[id] Владелец занятия Изменить или завершить занятие.
DELETE /api/instructor/tutor/appointments/[id] Владелец занятия Удалить занятие без начислений.
GET /api/instructor/tutor/finance Преподаватель Получить ручной журнал и балансы.
POST /api/instructor/tutor/finance Преподаватель Добавить платёж, начисление, возврат или корректировку.
GET /api/instructor/task-bank/items Доступ к банку Найти личные и встроенные шаблоны.
POST /api/instructor/task-bank/items Доступ к банку Создать личный шаблон задания.
GET /api/instructor/task-bank/items/[id] Доступ к банку Получить полный шаблон.
PATCH /api/instructor/task-bank/items/[id] Владелец шаблона Изменить личный шаблон.
DELETE /api/instructor/task-bank/items/[id] Владелец шаблона Архивировать личный шаблон.
POST /api/instructor/task-bank/items/from-step Редактирование курса Сохранить шаг как личный шаблон.
PUT /api/instructor/task-bank/items/[id]/favorite Доступ к банку Добавить шаблон в избранное.
DELETE /api/instructor/task-bank/items/[id]/favorite Доступ к банку Удалить шаблон из избранного.
POST /api/instructor/task-bank/placements Редактирование курса Вставить независимые копии заданий в урок.
GET /api/instructor/task-bank/collections Доступ к банку Получить личные подборки.
POST /api/instructor/task-bank/collections Доступ к банку Создать подборку.
PATCH /api/instructor/task-bank/collections/[id] Владелец подборки Изменить подборку.
DELETE /api/instructor/task-bank/collections/[id] Владелец подборки Удалить подборку.
PUT /api/instructor/task-bank/collections/[id]/items/[itemId] Владелец подборки Добавить задание в подборку.
DELETE /api/instructor/task-bank/collections/[id]/items/[itemId] Владелец подборки Убрать задание из подборки.

Карточки учащихся

Репетиторский контур отделён от обычных зачислений на курсы. Карточка хранит личные заметки, ставку, предмет и контактные данные. Явный выбор зачисленного пользователя при создании занятия может создать связанную карточку автоматически.

Групповое занятие

В одном занятии можно указать до 50 участников. Порядок сохраняется, а цена фиксируется отдельно для каждого участника:

{
  "studentIds": ["student-card-1", "student-card-2"],
  "startsAt": "2026-07-20T15:00:00.000Z",
  "endsAt": "2026-07-20T16:00:00.000Z",
  "title": "Разбор пробного варианта"
}

После создания начислений нельзя менять состав, цены и статус занятия. Ошибка исправляется отдельной корректировкой.

Ручной финансовый журнал

Журнал не принимает деньги и не связан с платёжным провайдером. Преподаватель вручную фиксирует фактические операции: PAYMENT, CHARGE, REFUND и ADJUSTMENT. Записи неизменяемы.

Банк заданий

Элемент банка — шаблон, а не живой шаг курса. При вставке в урок создаётся независимая копия, которую можно менять без влияния на источник. Размещаемая копия всегда проходит строгую проверку блока шага.

POST /api/instructor/task-bank/placements принимает урок и список шаблонов. В ответе возвращаются созданные шаги и происхождение каждой копии.

Поддержка