Заголовки запроса
API-токен сервисного пользователя в формате
Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете:
Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в
карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
Числовой ID школы, берётся там же, где
Seller-Id. Значение должно совпадать со школой продавца — иначе
вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".CourseManage). Метод доступен
только школам.
Метод создаёт курс с теми же параметрами, что и кнопка «Создать курс» в кабинете. Если передать modules, вместе с
курсом за один запрос создаётся всё его дерево: модули, уроки в них и блоки контента каждого урока. Без modules
создаётся пустой курс — уроки можно добавить позже в кабинете.
Вместе с курсом автоматически создаются:
- продукт курса — сразу опубликован; его ID приходит в поле
productIdответа; - группа по умолчанию («Группа 1») — в неё можно записывать пользователей.
ID группы вернёт Список групп с фильтром
courseIds.
update и get, даже
если у курса включён режим доступа «Назначенные».Лишние поля в теле запроса молча отбрасываются — ошибки не будет. Проверяйте написание полей по этой странице.
Параметры запроса
Курс
ID пользователей школы, которые будут указаны авторами курса. Пользователь API-ключа добавляется автоматически.
Передайте
[], если других авторов нет.Символьный адрес курса: латинские буквы, цифры и
_. Не может состоять только из цифр и должен быть уникальным.Только для
type: Bundle — курсы, входящие в пакет (до 50). Курсы и их группы должны принадлежать этой же школе.Поля
buildStatus и aiContext служебные — их заполняет мастер создания курса с ИИ. Не передавайте их: при
buildStatus: AiGenerating курс скрыт от всех, кроме автора.Модули и уроки
Модули курса — до 50. Порядок модулей, уроков и блоков в курсе совпадает с порядком в массивах.
Блоки контента
Каждый блок урока — объект с полями:Тип блока. Для уроков:
EditorJsBlock, TaskQuestion, Checklist, Button, Checkpoint, ChatMessage, Video,
Iframe, NotionPage. Другие значения (Text, Audio, Scorm, Survey и типы промо-блоков) не рекомендуется
создавать через API.EditorJsBlock — текст
EditorJsBlock — текст
Основной блок для теории: заголовки, абзацы, списки, цитаты, таблицы, разделитель.
content — документ
EditorJS. В тексте допустимы теги <b>, <i>, <u>, <a>.id внутренних блоков — произвольные уникальные строки. level у заголовка — 2 или 3, style у списка —
unordered или ordered.TaskQuestion — вопрос с автопроверкой
TaskQuestion — вопрос с автопроверкой
Вопрос с вариантами ответа, проверяется сразу в уроке.
answerType: Single — один верный вариант,
Multiple — несколько.messages необязателен. Если он задан, блоки ниже вопроса скрыты, пока ученик не ответит.Checklist — чек-лист
Checklist — чек-лист
Checkpoint — кнопка «Продолжить»
Checkpoint — кнопка «Продолжить»
Кнопка-разделитель: всё, что ниже, скрыто, пока ученик её не нажмёт.
ChatMessage — сообщения от наставника
ChatMessage — сообщения от наставника
Video — видео по ссылке
Video — видео по ссылке
Видео с видеохостинга (YouTube, Vimeo, Kinescope) — по ссылке, без загрузки файла.
Iframe — встраиваемая страница
Iframe — встраиваемая страница
NotionPage — страница Notion
NotionPage — страница Notion
Публичная страница Notion, отображается внутри урока.
Поля ответа
Созданный курс — объект
course. Дерево модулей и уроков в ответ не
входит.Ошибки
Связанные разделы
- Изменение курса — обновление полей курса
- Получение курса — полный объект курса по ID
- Запись на курс — выдача доступа через группу курса
- Объект
course— описание полей ответа
Требования к правам доступа
Требуется аутентификация по токену и право «Управление курсами» (
CourseManage).
Метод доступен только школам.Обновлено: 2026-09-28 05:04 UTC