Заголовки запроса
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".Возвращает записи прогресса по урокам выбранного курса для всех участников. Каждая запись соответствует
паре «пользователь + урок». Записи создаются по мере прохождения курса, поэтому для уроков, до которых
участник ещё не дошёл, записи может не быть. Фильтров по пользователю или уроку
у метода нет: фильтруйте по
userId / lessonId на своей стороне.Просмотр видео (
videoWatchPercent, videoProgresses) приходит только в этом методе. Вебхуки о нём
не сообщают, а updatedAt записи при просмотре не меняется: чтобы получить свежий процент, запросите
прогресс курса заново.Параметры пути
ID курса, прогресс по которому нужно получить, — поле
courseId из
списка курсов.Параметры запроса
Пагинация
Поля ответа
Постраничный список записей прогресса. Полная структура записи —
courseProgress в справочнике
course.Требования к правам доступа
Требуется аутентификация по токену и одно из прав: «Куратор курсов» (
CourseCurator) или «Управление пользователями школы» (SchoolManageUsers).Обновлено: 2026-11-11 10:36 UTC