Заголовки запроса
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".Возвращает доступы пользователей к продуктам школы. Все параметры фильтрации необязательны.
Параметры-массивы передаются повторением параметра:
userIds=1&userIds=2.Параметры запроса
Пагинация
Фильтрация
Только активные (
true) или неактивные (false) доступы. Доступ становится неактивным, например, когда
пользователя удаляют из всех групп продукта (member/delete-many).
Истечение срока (expireAt) проверяйте отдельно — фильтром expiryStatuses или expireAtDateRange.Фильтр по ID групп: доступы пользователей, которые сейчас состоят хотя бы в одной из указанных групп.
Статус срока действия доступа (значения объединяются через «ИЛИ»):
NoExpiry— бессрочный доступ (expireAt=null);Active— истекает более чем через 14 дней;Expiring— истекает в ближайшие 14 дней;Expired— срок уже истёк.
Фильтры биллинга (подписки/рассрочки)
Только с активным (
true) биллингом. «Активный» — продление не отменено и первая оплата уже прошла
(доступы в ожидании входного платежа, WaitingEntryFee, не считаются активными).Статус биллинга доступа:
Scheduled, Processing, Paid, Failed, WaitingEntryFee,
CanceledByUser, CanceledByFailedAutoCharge, CanceledByReinitialization,
CanceledByFailedManualCharge, CanceledByPreviousCancellation.Вложенные фильтры
Поля ответа
Постраничный список доступов (компактная проекция). Полная структура —
productAccess в справочнике
product.Требования к правам доступа
Требуется аутентификация по токену и одно из прав: «Управление пользователями школы» (
SchoolManageUsers)
или «Управление студентами курса» (CourseStudentManage).Обновлено: 2026-09-25 13:43 UTC