Skip to main content

Заголовки запроса

string
обязательно
API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».
integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".
Ограничение видимости курса на API не распространяется. У курса есть режимы доступа для команды школы («Все» / «Назначенные»), которые скрывают закрытый курс от менеджеров в интерфейсе. API отдаёт данные по всем курсам школы независимо от этих режимов — доступ определяется только токеном сервисного пользователя и его правами.
Все параметры фильтрации необязательны. Параметры-массивы передаются повторением параметра в строке запроса: courseIds=1&courseIds=2.

Параметры запроса

Пагинация

integer
Количество записей, которые нужно пропустить. По умолчанию 0.
integer
Номер страницы (альтернатива skip). Начинается с 1.
integer
Количество записей на странице. От 1 до 1000. По умолчанию 100.

Фильтрация

integer[]
Фильтр по ID курсов.
string[]
Фильтр по символьным алиасам курсов.
enum[]
Фильтр по типам курсов. Возможные значения: Bundle, Webinar, TextCourse, Assessment, VideoCourse, PersonalLesson.
string[]
Фильтр по тегам курса. До 50 символов на тег.
Поиск по названию курса. Максимум 50 символов.
integer[]
Фильтр по ID предметных категорий.
integer[]
Фильтр по ID контентных категорий.
boolean
Фильтр по архивности: true — только архивные курсы, false — только неархивные. Если не передан — возвращаются и те, и другие.
Параметры participation, manage и administrate входят в общую схему фильтра курсов, но в этом методе не применяются — ответ от них не зависит. Метод всегда возвращает курсы школы целиком (с учётом остальных фильтров).
object
Вложенный фильтр по доступам к продукту курса. Полный набор полей совпадает с фильтром метода «Список доступов к продуктам» (например, active, userIds, billingStatuses, expireAtDateRange).
object
Вложенный фильтр по продукту.

Поля ответа

object
Постраничный список курсов (компактная проекция). Полный объект курса отдаёт Получение курса, структура — в справочнике course.

Требования к правам доступа

Требуется аутентификация по токену и одно из прав: «Куратор курсов» (CourseCurator) или «Управление пользователями школы» (SchoolManageUsers).

Обновлено: 2026-09-28 05:04 UTC