> ## Documentation Index > Fetch the complete documentation index at: https://docs.exode.biz/llms.txt > Use this file to discover all available pages before exploring further. # Создание курса > Создание курса школы — сразу с модулями, уроками и блоками контента ## Заголовки запроса API-токен сервисного пользователя в формате `Bearer YOUR_TOKEN`. Токен выпускает владелец школы в кабинете: **Управление → Школа → Для разработчиков → API-ключи** — подробнее в разделе [«Аутентификация»](/ru/exode-api/setup#аутентификация). Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице **API-ключи** в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена. Числовой ID школы, берётся там же, где `Seller-Id`. Значение должно совпадать со школой продавца — иначе вернётся ошибка `400` с `cause: "ForbiddenSchoolMismatch"`. ``` POST /saas/v2/course/create ``` Требуется аутентификация и право [**«Управление курсами»**](/ru/exode-api/permissions) (`CourseManage`). Метод доступен только школам. Метод создаёт курс с теми же параметрами, что и кнопка «Создать курс» в кабинете. Если передать `modules`, вместе с курсом за один запрос создаётся всё его дерево: модули, уроки в них и блоки контента каждого урока. Без `modules` создаётся пустой курс — уроки можно добавить позже в кабинете. Вместе с курсом автоматически создаются: * **продукт** курса — сразу опубликован; его ID приходит в поле `productId` ответа; * **группа по умолчанию** («Группа 1») — в неё можно [записывать пользователей](/ru/exode-api/school/course/enroll). ID группы вернёт [Список групп](/ru/exode-api/school/group/list) с фильтром `courseIds`. Пользователь API-ключа становится автором курса и назначается его редактором, поэтому созданный курс доступен этому ключу в методах [`update`](/ru/exode-api/school/course/update) и [`get`](/ru/exode-api/school/course/get), даже если у курса включён режим доступа «Назначенные». **Создание не атомарно.** Курс, модули, уроки и блоки записываются последовательно, без общей транзакции. Ошибки валидации тела возвращаются до записи — тогда не создаётся ничего. Но если запрос оборвётся посередине записи (обрыв соединения, таймаут, сбой сервера), уже созданная часть останется в школе: курс будет собран не полностью. Повторный запрос создаст **новый** курс, а не дособерёт прежний — неполный курс удалите или допишите в кабинете. Лишние поля в теле запроса молча отбрасываются — ошибки не будет. Проверяйте написание полей по этой странице. ## Параметры запроса ### Курс Тип курса: `TextCourse`, `VideoCourse`, `Webinar`, `Assessment`, `PersonalLesson`, `Bundle`. Название курса. От 1 до 130 символов, пробелы по краям обрезаются. Описание курса. До 500 символов, может быть пустой строкой `""`. Теги курса. Каждый — от 2 символов. Передайте `[]`, если тегов нет. ID пользователей школы, которые будут указаны авторами курса. Пользователь API-ключа добавляется автоматически. Передайте `[]`, если других авторов нет. Символьный адрес курса: латинские буквы, цифры и `_`. Не может состоять только из цифр и должен быть уникальным. Изображения курса. URL основного изображения. URL изображения для карточки курса. Ссылка на промо-видео курса. SEO-теги. ID предметных категорий курса. ID контентной категории курса. Настройки курса. Все поля необязательны. Порядок прохождения: `ByOrder` — по порядку уроков, `ByUser` — в свободном порядке. Открытие уроков: `Free` — все сразу, `Sequence` — следующий после завершения предыдущего. Кто из команды школы видит курс в роли редактора: `All` — все с правом «Управление курсами», `Assigned` — только назначенные на курс. По умолчанию `All`, у корпоративных школ — `Assigned`. То же для кураторов: `All` или `Assigned`. Значение по умолчанию — как у `editorAccessMode`. Скрыть нумерацию модулей. Скрыть число участников. Включить геймификацию (звёзды) в курсе. Звёзд за прохождение урока по умолчанию, от `0`. Звёзд за верный ответ на задание по умолчанию, от `0`. Защита от записи экрана. Запрет копирования текста. Скрыть отзыв о курсе. Скрыть оценку уроков. Как собирать оценку: `ByLesson` — после каждого урока, `ByModule` — после модуля. Чат с куратором: `Hidden`, `Platform` (чат Exode) или `External` (внешняя ссылка из `curatorChatUrl`). Ссылка на внешний чат куратора (при `curatorChatMode: External`). До 255 символов. Своя ссылка, на которую ведёт карточка курса (URL). Сертификат о прохождении: `enabled`, `templateId` (обязателен при `enabled: true`, шаблон должен быть доступен школе), `expireInMonths`, `brandColor` (HEX), `signatureImageUrl`, `stampImageUrl`, `curatorName`, `curatorRole` (до 255 символов). Параметры продукта курса. Если не передан — продукт создаётся с настройками по умолчанию. Тип продукта: `Course`. Обязателен, если передан объект `product`. Валюта: `Free`, `Rub`, `Uzs`, `Kzt`, `Usd`, `Eur`. Показывать ли курс в каталоге школы. У корпоративных школ по умолчанию `false`. Способы записи (непустой массив): `ByAssignment` — назначение, `ByInviteLink` — по ссылке-приглашению, `ByApplication` — по заявке, `BySelfEnrollment` — самостоятельно. Начало продаж (ISO 8601), не позже `saleFinishAt`. Окончание продаж (ISO 8601), не раньше `saleStartAt`. Только для `type: Bundle` — курсы, входящие в пакет (до 50). Курсы и их группы должны принадлежать этой же школе. ID курса, входящего в пакет. Группа курса, в которую записывать участников пакета. Одна группа — не более чем в одной строке. Группы самого пакета, для которых действует строка. Поля `buildStatus` и `aiContext` служебные — их заполняет мастер создания курса с ИИ. Не передавайте их: при `buildStatus: AiGenerating` курс скрыт от всех, кроме автора. ### Модули и уроки Модули курса — до 50. Порядок модулей, уроков и блоков в курсе совпадает с порядком в массивах. Название модуля. До 120 символов. Описание модуля. До 500 символов, может быть `""`. Статус: `Draft`, `OnCheck` или `Published`. По умолчанию `Draft`. Доступ: `Participant` — только участникам курса (по умолчанию), `Demo` — открыт как демо. URL превью модуля. Уроки модуля — до 100. Название урока. До 120 символов. Описание урока. До 500 символов, может быть `""`. Статус: `Draft`, `OnCheck` или `Published`. По умолчанию `Draft`. Тип урока: `Regular` (по умолчанию) или `Webinar`. Доступ: `Participant` (по умолчанию) или `Demo`. URL превью урока. Создать у урока пустую практику — задания в неё добавляются в кабинете. По умолчанию `false`. Настройки урока: `starsForCompletion` (звёзд за прохождение, от `0`), `videoWatchPercentThreshold` (сколько процентов видео нужно досмотреть, от `1` до `100`), `scorm` (`completionThreshold` от `1` до `100`, `requireNotFailed`). Блоки контента урока — до 100. См. [«Блоки контента»](#блоки-контента). Модули и уроки создаются в статусе **`Draft`** — ученики их не видят. Чтобы материалы сразу стали доступны, передайте `status: "Published"` у модулей и уроков. Не передавайте `parentLessonId`: модуль и урок связываются вложенностью массивов. ### Блоки контента Каждый блок урока — объект с полями: Тип блока. Для уроков: `EditorJsBlock`, `TaskQuestion`, `Checklist`, `Button`, `Checkpoint`, `ChatMessage`, `Video`, `Iframe`, `NotionPage`. Другие значения (`Text`, `Audio`, `Scorm`, `Survey` и типы промо-блоков) не рекомендуется создавать через API. Заголовок над блоком в уроке. Содержимое блока. Форма зависит от `type` — см. примеры ниже. **`content` не проверяется API**: блок сохраняется как передан. Блок с неверной формой `content` создастся, но в уроке отобразится пустым или сломанным. Сверяйте форму с примерами. Все `uuid` внутри `content` генерируйте на своей стороне (UUID v4), уникальными в пределах блока. Блоки с файлами (загруженное видео, аудио, SCORM-пакет) через API не создать — файл загружается в кабинете. Основной блок для теории: заголовки, абзацы, списки, цитаты, таблицы, разделитель. `content` — документ [EditorJS](https://editorjs.io/). В тексте допустимы теги ``, ``, ``, ``. ```json theme={null} { "type": "EditorJsBlock", "content": { "time": 0, "version": "2.29.1", "blocks": [ { "id": "h-1", "type": "header", "data": { "text": "Зачем нужна охрана труда", "level": 2 } }, { "id": "p-1", "type": "paragraph", "data": { "text": "Правила защищают вас и коллег." } }, { "id": "l-1", "type": "list", "data": { "style": "unordered", "items": ["Каска", "Перчатки"] } }, { "id": "q-1", "type": "quote", "data": { "text": "Безопасность — прежде всего.", "caption": "Инструкция" } }, { "id": "d-1", "type": "delimiter", "data": {} }, { "id": "t-1", "type": "table", "data": { "withHeadings": true, "content": [["Средство", "Когда"], ["Каска", "Всегда"]] } } ] } } ``` `id` внутренних блоков — произвольные уникальные строки. `level` у заголовка — `2` или `3`, `style` у списка — `unordered` или `ordered`. Вопрос с вариантами ответа, проверяется сразу в уроке. `answerType`: `Single` — один верный вариант, `Multiple` — несколько. ```json theme={null} { "type": "TaskQuestion", "title": "Проверьте себя", "content": { "uuid": "7f1c2a4e-3b5d-4c6e-8f9a-0b1c2d3e4f50", "task": { "title": "Кто проводит вводный инструктаж?", "answerType": "Single", "question": { "variants": [ { "uuid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "text": "Специалист по охране труда", "correct": true }, { "uuid": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "text": "Сам сотрудник", "correct": false } ] } }, "messages": { "correct": "Верно — инструктаж проводит специалист.", "incorrect": "Инструктаж проводит специалист по охране труда." } } } ``` `messages` необязателен. Если он задан, блоки ниже вопроса скрыты, пока ученик не ответит. ```json theme={null} { "type": "Checklist", "content": { "items": [ { "uuid": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f", "text": "Прочитать инструкцию" }, { "uuid": "d2e3f4a5-b6c7-4d8e-9f0a-1b2c3d4e5f6a", "text": "Подписать журнал" } ] } } ``` ```json theme={null} { "type": "Button", "content": { "buttons": [ { "uuid": "e3f4a5b6-c7d8-4e9f-0a1b-2c3d4e5f6a7b", "text": "Открыть регламент", "link": "https://example.com/rules", "target": "_blank" } ] } } ``` `target` — `_blank` (новая вкладка) или `_self`. Кнопка-разделитель: всё, что ниже, скрыто, пока ученик её не нажмёт. ```json theme={null} { "type": "Checkpoint", "content": { "uuid": "f4a5b6c7-d8e9-4f0a-1b2c-3d4e5f6a7b8c", "text": "Я прочитал, дальше" } } ``` ```json theme={null} { "type": "ChatMessage", "content": { "senderName": "Анна, наставник", "messages": [ { "uuid": "a5b6c7d8-e9f0-4a1b-2c3d-4e5f6a7b8c9d", "text": "Привет! Сегодня разберём технику безопасности." } ] } } ``` Видео с видеохостинга (YouTube, Vimeo, Kinescope) — по ссылке, без загрузки файла. ```json theme={null} { "type": "Video", "title": "Вводная лекция", "content": { "type": "ThirdParty", "location": "https://www.youtube.com/watch?v=VIDEO_ID" } } ``` ```json theme={null} { "type": "Iframe", "content": { "src": "https://example.com/embed" } } ``` Публичная страница Notion, отображается внутри урока. ```json theme={null} { "type": "NotionPage", "content": { "notionUrl": "https://example.notion.site/Page-Title-0123456789abcdef0123456789abcdef" } } ``` ## Поля ответа Созданный курс — объект [`course`](/ru/exode-api/objects/entities/course). Дерево модулей и уроков в ответ не входит. ```bash cURL theme={null} curl --location 'https://api.exode.biz/saas/v2/course/create' \ --header 'Seller-Id: {{ sellerId }}' \ --header 'School-Id: {{ schoolId }}' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --data-raw '{ "type": "TextCourse", "name": "Охрана труда для новых сотрудников", "description": "Вводный курс по технике безопасности", "tags": ["охрана труда"], "authors": [], "modules": [ { "name": "Модуль 1. Основы", "description": "", "status": "Published", "lessons": [ { "name": "Урок 1. Зачем нужна охрана труда", "description": "", "status": "Published", "blocks": [ { "type": "EditorJsBlock", "content": { "time": 0, "version": "2.29.1", "blocks": [ { "id": "h-1", "type": "header", "data": { "text": "Зачем нужна охрана труда", "level": 2 } }, { "id": "p-1", "type": "paragraph", "data": { "text": "Правила защищают вас и коллег." } } ] } } ] } ] } ] }' ``` ```javascript Node.js theme={null} const axios = require('axios'); const createCourse = async () => { try { const response = await axios.post('https://api.exode.biz/saas/v2/course/create', { type: 'TextCourse', name: 'Охрана труда для новых сотрудников', description: 'Вводный курс по технике безопасности', tags: ['охрана труда'], authors: [], modules: [ { name: 'Модуль 1. Основы', description: '', status: 'Published', lessons: [ { name: 'Урок 1. Зачем нужна охрана труда', description: '', status: 'Published', blocks: [ { type: 'EditorJsBlock', content: { time: 0, version: '2.29.1', blocks: [ { id: 'h-1', type: 'header', data: { text: 'Зачем нужна охрана труда', level: 2 } }, { id: 'p-1', type: 'paragraph', data: { text: 'Правила защищают вас и коллег.' } } ] } } ] } ] } ] }, { headers: { 'Seller-Id': '{{ sellerId }}', 'School-Id': '{{ schoolId }}', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_TOKEN' } }); console.log('Course created:', response.data.payload); } catch (error) { console.error('Error:', error.response?.data || error.message); } }; createCourse(); ``` ```php PHP theme={null} 'TextCourse', 'name' => 'Охрана труда для новых сотрудников', 'description' => 'Вводный курс по технике безопасности', 'tags' => ['охрана труда'], 'authors' => [], 'modules' => [ [ 'name' => 'Модуль 1. Основы', 'description' => '', 'status' => 'Published', 'lessons' => [ [ 'name' => 'Урок 1. Зачем нужна охрана труда', 'description' => '', 'status' => 'Published', 'blocks' => [ [ 'type' => 'EditorJsBlock', 'content' => [ 'time' => 0, 'version' => '2.29.1', 'blocks' => [ ['id' => 'h-1', 'type' => 'header', 'data' => ['text' => 'Зачем нужна охрана труда', 'level' => 2]], ['id' => 'p-1', 'type' => 'paragraph', 'data' => ['text' => 'Правила защищают вас и коллег.']] ] ] ] ] ] ] ] ] ]; $headers = [ 'Seller-Id: {{ sellerId }}', 'School-Id: {{ schoolId }}', 'Content-Type: application/json', 'Authorization: Bearer YOUR_TOKEN' ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data, JSON_UNESCAPED_UNICODE)); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if ($httpCode === 201) { $result = json_decode($response, true); echo "Course created: " . $result['payload']['id'] . "\n"; } else { echo "Error: HTTP $httpCode\n"; echo $response; } ?> ``` ```python Python theme={null} import requests url = 'https://api.exode.biz/saas/v2/course/create' data = { 'type': 'TextCourse', 'name': 'Охрана труда для новых сотрудников', 'description': 'Вводный курс по технике безопасности', 'tags': ['охрана труда'], 'authors': [], 'modules': [ { 'name': 'Модуль 1. Основы', 'description': '', 'status': 'Published', 'lessons': [ { 'name': 'Урок 1. Зачем нужна охрана труда', 'description': '', 'status': 'Published', 'blocks': [ { 'type': 'EditorJsBlock', 'content': { 'time': 0, 'version': '2.29.1', 'blocks': [ { 'id': 'h-1', 'type': 'header', 'data': { 'text': 'Зачем нужна охрана труда', 'level': 2 } }, { 'id': 'p-1', 'type': 'paragraph', 'data': { 'text': 'Правила защищают вас и коллег.' } } ] } } ] } ] } ] } headers = { 'Seller-Id': '{{ sellerId }}', 'School-Id': '{{ schoolId }}', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_TOKEN' } response = requests.post(url, json=data, headers=headers) print(response.json()) ``` ```bsl 1С theme={null} ВнутреннийБлок = Новый Структура; ВнутреннийБлок.Вставить("id", "p-1"); ВнутреннийБлок.Вставить("type", "paragraph"); ВнутреннийБлок.Вставить("data", Новый Структура("text", "Правила защищают вас и коллег.")); СодержимоеБлока = Новый Структура; СодержимоеБлока.Вставить("time", 0); СодержимоеБлока.Вставить("version", "2.29.1"); СодержимоеБлока.Вставить("blocks", Новый Массив); СодержимоеБлока.blocks.Добавить(ВнутреннийБлок); Блок = Новый Структура; Блок.Вставить("type", "EditorJsBlock"); Блок.Вставить("content", СодержимоеБлока); Урок = Новый Структура; Урок.Вставить("name", "Урок 1. Зачем нужна охрана труда"); Урок.Вставить("description", ""); Урок.Вставить("status", "Published"); Урок.Вставить("blocks", Новый Массив); Урок.blocks.Добавить(Блок); Модуль = Новый Структура; Модуль.Вставить("name", "Модуль 1. Основы"); Модуль.Вставить("description", ""); Модуль.Вставить("status", "Published"); Модуль.Вставить("lessons", Новый Массив); Модуль.lessons.Добавить(Урок); Данные = Новый Структура; Данные.Вставить("type", "TextCourse"); Данные.Вставить("name", "Охрана труда для новых сотрудников"); Данные.Вставить("description", "Вводный курс по технике безопасности"); Данные.Вставить("tags", Новый Массив); Данные.tags.Добавить("охрана труда"); Данные.Вставить("authors", Новый Массив); Данные.Вставить("modules", Новый Массив); Данные.modules.Добавить(Модуль); ЗаписьJSON = Новый ЗаписьJSON; ЗаписьJSON.УстановитьСтроку(); ЗаписатьJSON(ЗаписьJSON, Данные); ТелоЗапроса = ЗаписьJSON.Закрыть(); Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 60, Новый OpenSSLSecureConnection); Запрос = Новый HTTPЗапрос("/saas/v2/course/create"); Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}"); Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}"); Запрос.Заголовки.Вставить("Content-Type", "application/json"); Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN"); Запрос.УстановитьТелоИзСтроки(ТелоЗапроса); Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос); Если Ответ.КодСостояния = 201 Тогда Сообщить("Курс создан"); Иначе Сообщить("Ошибка: HTTP " + Ответ.КодСостояния); Сообщить(Ответ.ПолучитьТелоКакСтроку()); КонецЕсли; ``` ```json Success theme={null} { "success": true, "code": 201, "payload": { "id": 412, "createdAt": "2026-09-28T09:12:03.518Z", "updatedAt": "2026-09-28T09:12:03.941Z", "archivedAt": null, "type": "TextCourse", "productId": 1290, "buildStatus": "Ready", "name": "Охрана труда для новых сотрудников", "description": "Вводный курс по технике безопасности", "alias": null, "tags": [ "охрана труда" ], "seoTags": [], "image": { "main": "" }, "promoVideo": null, "settings": { "editorAccessMode": "All", "curatorAccessMode": "All" }, "order": 0, "isBundle": false } } ``` ```json Error - Validation theme={null} { "code": 400, "success": false, "cause": "validation", "message": [ "modules.0.lessons.0.name must be shorter than or equal to 120 characters" ], "error": "Bad Request" } ``` ```json Error - Plan Limit Reached theme={null} { "code": 402, "success": false, "cause": "SaasLimitReached", "message": "School plan limit reached: maxActiveProducts (10/10)", "error": "School plan limit reached: maxActiveProducts (10/10)", "data": { "max": 10, "current": 10, "feature": "maxActiveProducts" } } ``` ```json Error - Alias Already Busy theme={null} { "code": 400, "success": false, "cause": "AliasAlreadyBusy", "message": "Этот адрес уже занят", "error": "Этот адрес уже занят" } ``` ```json Error - Certificate Template Required theme={null} { "code": 400, "success": false, "cause": "CertificateTemplateRequired", "message": "Certificate template is required", "error": "Certificate template is required" } ``` ```json Error - Forbidden theme={null} { "code": 401, "success": false, "cause": "Forbidden", "message": "Forbidden seller resource - permissions CourseManage", "error": "Forbidden seller resource - permissions CourseManage" } ``` ## Ошибки | HTTP | `cause` | Когда возникает | | - | - | - | | 400 | `validation` | Тело не прошло проверку: тип, длина, enum, лимиты (50 модулей, 100 уроков в модуле, 100 блоков в уроке). Путь к полю — в `message` | | 400 | `InvalidAlias` | `alias` содержит недопустимые символы или состоит только из цифр | | 400 | `AliasAlreadyBusy` | `alias` уже занят другим курсом | | 400 | `CertificateTemplateRequired` | Сертификат включён, но не передан `templateId` | | 400 | `CertificateTemplateNotAvailable` | Шаблон сертификата недоступен школе | | 400 | `BundleGroupAlreadyUsed` | Одна группа указана в нескольких строках `bundleCourses` | | 400 | `BundleCourseSellerMismatch` | Курс или группа из `bundleCourses` принадлежит другой школе | | 401 | `Forbidden` | У ключа нет права `CourseManage` или метод вызван не для школы (`Allowed only for school`) | | 402 | `SaasLimitReached` | Достигнут лимит тарифа на число активных продуктов. В `data` — `feature`, `current`, `max` | ## Связанные разделы * [Изменение курса](/ru/exode-api/school/course/update) — обновление полей курса * [Получение курса](/ru/exode-api/school/course/get) — полный объект курса по ID * [Запись на курс](/ru/exode-api/school/course/enroll) — выдача доступа через группу курса * [Объект `course`](/ru/exode-api/objects/entities/course) — описание полей ответа ## Требования к правам доступа Требуется аутентификация по токену и право [**«Управление курсами»**](/ru/exode-api/permissions) (`CourseManage`). Метод доступен только школам. *** *Обновлено: 2026-09-28 05:04 UTC* This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.