> ## 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. Получите токен в панели администратора школы. Формат: `Bearer YOUR_TOKEN`. Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами. Уникальный идентификатор школы в системе. Определяет контекст выполнения операции. ``` POST /saas/v2/form/layout/create ``` Требуется аутентификация и право `FormManage`. ## Параметры запроса Режим макета формы. Определяет где и как будет использоваться форма. Возможные значения: * `Custom` — кастомные поля пользователя * `Form` — заполняемая форма (анкета) * `Signup` — форма при регистрации (уникальная для школы) * `Welcome` — приветственная форма (уникальная для школы) * `Participant` — форма участника продукта Название макета формы. Максимум 255 символов. Внутреннее название макета. Максимум 255 символов. Используется для идентификации макета в интерфейсе управления. Статус макета. Возможные значения: `Draft`, `Published`. По умолчанию `Draft`. Символьный код макета. От 1 до 50 символов. Должен быть уникальным в рамках школы. Заметка к макету. Максимум 255 символов. Массив ID продуктов, к которым привязан макет. Настройки макета. Режим повторной отправки формы. Возможные значения: * `Overwrite` — перезаписать существующее заполнение (по умолчанию) * `NewFill` — создать новое заполнение * `NotAllowed` — повторная отправка запрещена Для режимов `Signup` и `Welcome` допускается только один макет на школу. При попытке создать второй — существующий макет будет обновлён. ```bash cURL theme={null} curl --location 'https://api.exode.biz/saas/v2/form/layout/create' \ --header 'Seller-Id: {{ sellerId }}' \ --header 'School-Id: {{ schoolId }}' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_TOKEN' \ --data-raw '{ "mode": "Custom", "name": "Доп. данные клиента", "internalName": "CRM доп. поля", "status": "Published", "slug": "client-extra", "note": "Дополнительные поля для CRM", "config": { "resubmitMode": "Overwrite" } }' ``` ```javascript Node.js theme={null} const axios = require('axios'); const createLayout = async () => { try { const response = await axios.post('https://api.exode.biz/saas/v2/form/layout/create', { mode: 'Custom', name: 'Доп. данные клиента', internalName: 'CRM доп. поля', status: 'Published', slug: 'client-extra', note: 'Дополнительные поля для CRM', config: { resubmitMode: 'Overwrite' } }, { headers: { 'Seller-Id': '{{ sellerId }}', 'School-Id': '{{ schoolId }}', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_TOKEN' } }); console.log('Layout created:', response.data.payload); } catch (error) { console.error('Error:', error.response?.data || error.message); } }; createLayout(); ``` ```php PHP theme={null} 'Custom', 'name' => 'Доп. данные клиента', 'internalName' => 'CRM доп. поля', 'status' => 'Published', 'slug' => 'client-extra', 'note' => 'Дополнительные поля для CRM', 'config' => [ 'resubmitMode' => 'Overwrite' ] ]; $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)); 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 === 200) { $result = json_decode($response, true); echo "Layout created successfully\n"; print_r($result['payload']); } else { echo "Error: HTTP $httpCode\n"; echo $response; } ?> ``` ```python Python theme={null} import requests import json url = 'https://api.exode.biz/saas/v2/form/layout/create' data = { 'mode': 'Custom', 'name': 'Доп. данные клиента', 'internalName': 'CRM доп. поля', 'status': 'Published', 'slug': 'client-extra', 'note': 'Дополнительные поля для CRM', 'config': { 'resubmitMode': 'Overwrite' } } headers = { 'Seller-Id': '{{ sellerId }}', 'School-Id': '{{ schoolId }}', 'Content-Type': 'application/json', 'Authorization': 'Bearer YOUR_TOKEN' } try: response = requests.post(url, json=data, headers=headers) response.raise_for_status() result = response.json() print('Layout created successfully:') print(json.dumps(result['payload'], indent=2, ensure_ascii=False)) except requests.exceptions.RequestException as e: print(f'Error: {e}') if hasattr(e, 'response') and e.response is not None: print(f'Response: {e.response.text}') ``` ```bsl 1С theme={null} Конфигурация = Новый Структура; Конфигурация.Вставить("resubmitMode", "Overwrite"); Данные = Новый Структура; Данные.Вставить("mode", "Custom"); Данные.Вставить("name", "Доп. данные клиента"); Данные.Вставить("internalName", "CRM доп. поля"); Данные.Вставить("status", "Published"); Данные.Вставить("slug", "client-extra"); Данные.Вставить("note", "Дополнительные поля для CRM"); Данные.Вставить("config", Конфигурация); // Serialize body to JSON ЗаписьJSON = Новый ЗаписьJSON; ЗаписьJSON.УстановитьСтроку(); ЗаписатьJSON(ЗаписьJSON, Данные); ТелоЗапроса = ЗаписьJSON.Закрыть(); Соединение = Новый HTTPСоединение("api.exode.biz", 443, , , , 30, Новый OpenSSLSecureConnection); Запрос = Новый HTTPЗапрос("/saas/v2/form/layout/create"); Запрос.Заголовки.Вставить("Seller-Id", "{{ sellerId }}"); Запрос.Заголовки.Вставить("School-Id", "{{ schoolId }}"); Запрос.Заголовки.Вставить("Content-Type", "application/json"); Запрос.Заголовки.Вставить("Authorization", "Bearer YOUR_TOKEN"); Запрос.УстановитьТелоИзСтроки(ТелоЗапроса); Ответ = Соединение.ВызватьHTTPМетод("POST", Запрос); Если Ответ.КодСостояния = 200 Тогда ЧтениеJSON = Новый ЧтениеJSON; ЧтениеJSON.УстановитьСтроку(Ответ.ПолучитьТелоКакСтроку()); Результат = ПрочитатьJSON(ЧтениеJSON); Сообщить("Форма создана"); Иначе Сообщить("Ошибка: HTTP " + Ответ.КодСостояния); Сообщить(Ответ.ПолучитьТелоКакСтроку()); КонецЕсли; ``` ```json Success theme={null} { "success": true, "code": 200, "payload": { "id": 5, "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "mode": "Custom", "status": "Published", "slug": "client-extra", "name": "Доп. данные клиента", "internalName": "CRM доп. поля", "note": "Дополнительные поля для CRM", "sellerId": 1, "createdAt": "2025-03-10T12:00:00.000Z", "updatedAt": "2025-03-10T12:00:00.000Z", "config": { "resubmitMode": "Overwrite" } } } ``` ```json Error - Duplicate Slug theme={null} { "code": 400, "success": false, "cause": "QueryFailedError", "message": "duplicate key value violates unique constraint", "error": "duplicate key value violates unique constraint" } ``` ```json Error - Validation theme={null} { "code": 400, "success": false, "cause": "BadRequest", "message": "name must be shorter than or equal to 255 characters", "error": "name must be shorter than or equal to 255 characters" } ``` ## Требования к правам доступа Для создания макета формы требуется **право FormManage** у сервисного пользователя. Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.