Добавить пользовательский блок в репозиторий landing.repo.register

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: landing

Кто может выполнять метод: пользователь с правом Просмотр в разделе Сайты

Метод landing.repo.register добавляет новый пользовательский блок в репозиторий.

Метод обновляет блок, если он уже существует с этим же кодом для текущего приложения. Если не существует — создает новый.

Параметры метода

Обязательные параметры отмечены *

Название `тип`	Описание
code^* `string`	Уникальный код блока
fields^* `object`	Поля блока подробнее
manifest `object`	Манифест блока. Структуру манифеста смотрите в методе landing.block.getManifestFile и в разделе Файл манифеста

Тип fields

Обязательные параметры отмечены *

Название `тип`	Описание
NAME^* `string`	Название блока
CONTENT^* `string`	HTML-содержимое блока. Перед сохранением проходит sanitize-проверку
SECTIONS^* `string`	Категории блока строкой через запятую, например `cover,about`
PREVIEW^* `string`	URL превью блока
DESCRIPTION `string`	Описание блока
ACTIVE `string`	Активность блока (`Y`/`N`)
SITE_TEMPLATE_ID `string`	Привязка блока к шаблону сайта
RESET `string`	Если передать `Y`, метод регистрирует обновление добавленных на страницы блоков с кодом `repo_<ID>`

Примеры кода

Как использовать примеры в документации

Пример регистрации блока, где:

code — уникальный код блока myblockx
fields — основные параметры блока (NAME, DESCRIPTION, SECTIONS, PREVIEW, CONTENT)
manifest — базовый манифест блока с описанием block и nodes

cURL (Webhook)

cURL (OAuth)

PHP

BX24.js

PHP CRest

curl -X POST \
          -H "Content-Type: application/json" \
          -d '{
            "code": "myblockx",
            "fields": {
              "NAME": "Test block",
              "DESCRIPTION": "Just try!",
              "SECTIONS": "cover,about",
              "PREVIEW": "https://www.bitrix24.ru/images/b24_screen.png",
              "CONTENT": "<section class=\"landing-block\"><div class=\"container\">Test</div></section>"
            },
            "manifest": {
              "block": {"name": "Test block"},
              "nodes": {
                ".landing-block-node-text": {"name": "Text", "type": "text"}
              }
            }
          }' \
          "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.repo.register.json"

curl -X POST \
          -H "Content-Type: application/json" \
          -d '{
            "code": "myblockx",
            "fields": {
              "NAME": "Test block",
              "SECTIONS": "cover,about",
              "PREVIEW": "https://www.bitrix24.ru/images/b24_screen.png",
              "CONTENT": "<section class=\"landing-block\"><div class=\"container\">Test</div></section>"
            },
            "manifest": {
              "block": {"name": "Test block"}
            },
            "auth": "**put_access_token_here**"
          }' \
          "https://**put.your-domain-here**/rest/landing.repo.register.json"

try
        {
        	const response = await $b24.callMethod(
        		'landing.repo.register',
        		{
        			code: 'myblockx',
        			fields: {
        				NAME: 'Test block',
        				DESCRIPTION: 'Just try!',
        				SECTIONS: 'cover,about',
        				PREVIEW: 'https://www.bitrix24.ru/images/b24_screen.png',
        				CONTENT: '<section class="landing-block"><div class="container">Test</div></section>'
        			},
        			manifest: {
        				block: { name: 'Test block' },
        				nodes: {
        					'.landing-block-node-text': { name: 'Text', type: 'text' }
        				}
        			}
        		}
        	);
        
        	console.info(response.getData().result);
        }
        catch (error)
        {
        	console.error(error);
        }

try {
            $response = $b24Service
                ->core
                ->call(
                    'landing.repo.register',
                    [
                        'code' => 'myblockx',
                        'fields' => [
                            'NAME' => 'Test block',
                            'DESCRIPTION' => 'Just try!',
                            'SECTIONS' => 'cover,about',
                            'PREVIEW' => 'https://www.bitrix24.ru/images/b24_screen.png',
                            'CONTENT' => '<section class="landing-block"><div class="container">Test</div></section>',
                        ],
                        'manifest' => [
                            'block' => ['name' => 'Test block'],
                            'nodes' => [
                                '.landing-block-node-text' => ['name' => 'Text', 'type' => 'text'],
                            ],
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error calling landing.repo.register: ' . $e->getMessage();
        }

BX24.callMethod(
            'landing.repo.register',
            {
                code: 'myblockx',
                fields: {
                    NAME: 'Test block',
                    DESCRIPTION: 'Just try!',
                    SECTIONS: 'cover,about',
                    PREVIEW: 'https://www.bitrix24.ru/images/b24_screen.png',
                    CONTENT: '<section class="landing-block"><div class="container">Test</div></section>'
                },
                manifest: {
                    block: { name: 'Test block' },
                    nodes: {
                        '.landing-block-node-text': { name: 'Text', type: 'text' }
                    }
                }
            },
            function(result)
            {
                if (result.error())
                {
                    console.error(result.error());
                }
                else
                {
                    console.info(result.data());
                }
            }
        );

require_once('crest.php');
        
        $result = CRest::call(
            'landing.repo.register',
            [
                'code' => 'myblockx',
                'fields' => [
                    'NAME' => 'Test block',
                    'DESCRIPTION' => 'Just try!',
                    'SECTIONS' => 'cover,about',
                    'PREVIEW' => 'https://www.bitrix24.ru/images/b24_screen.png',
                    'CONTENT' => '<section class="landing-block"><div class="container">Test</div></section>',
                ],
                'manifest' => [
                    'block' => ['name' => 'Test block'],
                ],
            ]
        );
        
        echo '<pre>';
        print_r($result);
        echo '</pre>';

Обработка ответа

HTTP-статус: 200

{
            "result": 7,
            "time": {
                "start": 1774879194,
                "finish": 1774879194.526507,
                "duration": 0.5265069007873535,
                "processing": 0,
                "date_start": "2026-03-30T16:59:54+03:00",
                "date_finish": "2026-03-30T16:59:54+03:00",
                "operating_reset_at": 1774879794,
                "operating": 0
            }
        }

Возвращаемые данные

Название `тип`	Описание
result `integer`	Идентификатор добавленного или обновленного блока в репозитории
time `time`	Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
            "error": "MANIFEST_INTERSECT_IMG",
            "error_description": "Редактируемый элемент манифеста \".landing-block-node-text\" не может иметь стилевой тип \"Изображение\". Измените стилевой тип."
        }

{
            "error": "ERROR_ARGUMENT",
            "error_description": "The value of an argument 'code' has an invalid type",
            "argument": "code"
        }

Название `тип`	Описание
error `string`	Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания
error_description `error_description`	Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде

Возможные коды ошибок

Код	Описание	Значение
`ACCESS_DENIED`	Недостаточно прав	Пользователь не прошел общие проверки доступа
`ERROR_ARGUMENT`	Некорректный тип аргумента	Передан аргумент в неверном типе. Название аргумента возвращается в поле `argument`
`MISSING_PARAMS`	Недостаточно параметров вызова	Не передан обязательный параметр (`code` или `fields`)
`REQUIRED_FIELD_NO_EXISTS`	Отсутствует обязательное поле	Не передано одно из полей: `NAME`, `CONTENT`, `SECTIONS`, `PREVIEW`
`MANIFEST_INTERSECT_IMG`	Конфликт типов в манифесте	Для одного селектора задан `node` и стиль с типом `background`, `block-default` или `block-border`
`CONTENT_IS_BAD`	Небезопасный контент блока	Поле `fields.CONTENT` не прошло sanitize-проверку
`PRESET_CONTENT_IS_BAD`	Небезопасный контент пресета	Небезопасное содержимое в `manifest.cards[].presets[]`
`UNSUPPORTED_BLOCK_TYPE`	Неподдерживаемый тип блока	В коде метода проверяется ограничение на `MAINPAGE` в `manifest.block.type`
`UNSUPPORTED_BLOCK_SUBTYPE`	Неподдерживаемый подтип блока	В `manifest.block.subtype` передан `widget`
`insufficient_scope`	Недостаточно scope у токена	Токен не содержит scope `landing`
`SYSTEM_ERROR`	Внутренняя ошибка	Ошибка выполнения на стороне сервера

Статусы и коды системных ошибок

HTTP-статус: 20x, 40x, 50x

Описанные ниже ошибки могут возникнуть при вызове любого метода

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`429`	`OPERATION_TIME_LIMIT` Method is blocked due to operation time limit	Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически через 10 минут
`405`	`ERROR_BATCH_METHOD_NOT_ALLOWED` Method is not allowed for batch usage	Текущий метод не разрешен для вызова с помощью batch
`400`	`ERROR_BATCH_LENGTH_EXCEEDED` Max batch length exceeded	Превышена максимальная длина параметров, переданных в метод batch
`401`	`NO_AUTH_FOUND` Wrong authorization data	Неверный access-токен или код вебхука
`400`	`INVALID_REQUEST` Https required	Для вызовов методов требуется использовать протокол HTTPS
`503`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24
`403`	`ACCESS_DENIED` REST API is available only on commercial plans	REST API доступен только на коммерческих планах
`403`	`INVALID_CREDENTIALS` Invalid request credentials	У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав
`404`	`ERROR_MANIFEST_IS_NOT_AVAILABLE` Manifest is not available	Манифест недоступен
`403`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более высоких привилегий, чем предоставляет токен вебхука
`401`	`expired_token` The access token provided has expired	Предоставленный access-токен доступа истек
`403`	`user_access_error` The user does not have access to the application	Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям
`500`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Обзор методов

Получить список блоков

Добавить пользовательский блок в репозиторий landing.repo.register

Параметры методаПараметры метода

Тип fieldsТип fields

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

Возвращаемые данныеВозвращаемые данные

Обработка ошибокОбработка ошибок

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение