Заголовки запроса
string
обязательно
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".Возвращает сертификаты, выданные за курсы школы. Все параметры фильтрации необязательны — без них
метод отдаёт все сертификаты школы постранично, от новых к старым (по убыванию
certificateId).
Параметры-массивы передаются повторением параметра: courseIds=1&courseIds=2.Параметры запроса
Пагинация
integer
Количество записей, которые нужно пропустить. По умолчанию
0.integer
Номер страницы (альтернатива
skip). Начинается с 1.integer
Количество записей на странице. От
1 до 1000. По умолчанию 100.Фильтрация
integer[]
Фильтр по ID сертификатов.
integer[]
Фильтр по ID курсов, за которые выдан сертификат.
integer[]
Фильтр по ID пользователей-получателей.
integer[]
Фильтр по ID групп. Группа привязана к получателю, а не к сертификату: в выборку попадают
сертификаты пользователей, состоящих хотя бы в одной из указанных групп.
object
Диапазон даты выдачи.
boolean
Фильтр по архивности сертификата:
true — только архивные, false — только неархивные. Если не передан —
возвращаются и те, и другие.Поля ответа
object
Постраничный список сертификатов (компактная проекция). Полная структура — в справочнике
certificate.Требования к правам доступа
Требуется аутентификация по токену и одно из прав: «Управление курсами» (
CourseManage)
или «Управление студентами курса» (CourseStudentManage).Обновлено: 2026-09-25 13:43 UTC