Получить манифест блока landing.block.getmanifest
Scope:
landingКто может выполнять метод: пользователь с правом «просмотр» страниц
Метод landing.block.getmanifest возвращает подготовленный манифест блока, размещенного на странице.
Он возвращает не исходный файл, а подготовленные данные для конкретного блока. Например, локализованные названия, поля code, preview, assets, timestamp, callbacks.
Параметры метода
Обязательные параметры отмечены *
|
Название |
Описание |
|
lid* |
Идентификатор страницы. Идентификатор страницы можно получить методом landing.landing.getlist |
|
block* |
Идентификатор блока. Блок должен принадлежать странице Идентификатор блока можно получить методом landing.block.getlist |
|
params |
Дополнительные параметры чтения манифеста (подробное описание) |
Параметр params
|
Название |
Описание |
|
Если значение приводится к Без этого параметра метод ищет блок только в опубликованной версии страницы |
Примеры кода
Как использовать примеры в документации
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"lid": 4858,
"block": 39556,
"params": {
"edit_mode": true
}
}' \
"https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.block.getmanifest.json"
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"lid": 4858,
"block": 39556,
"params": {
"edit_mode": true
},
"auth": "**put_access_token_here**"
}' \
"https://**put.your-domain-here**/rest/landing.block.getmanifest.json"
try
{
const response = await $b24.callMethod(
'landing.block.getmanifest',
{
lid: 4858,
block: 39556,
params: {
edit_mode: true
}
}
);
const result = response.getData().result;
console.info(result);
}
catch (error)
{
console.error(error);
}
try {
$response = $b24Service
->core
->call(
'landing.block.getmanifest',
[
'lid' => 4858,
'block' => 39556,
'params' => [
'edit_mode' => true,
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . var_export($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error getting block manifest: ' . $e->getMessage();
}
BX24.callMethod(
'landing.block.getmanifest',
{
lid: 4858,
block: 39556,
params: {
edit_mode: true
}
},
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'landing.block.getmanifest',
[
'lid' => 4858,
'block' => 39556,
'params' => [
'edit_mode' => true,
],
]
);
if (isset($result['error']))
{
echo 'Ошибка: ' . $result['error_description'];
}
else
{
echo '<pre>';
print_r($result['result']);
echo '</pre>';
}
Обработка ответа
HTTP-статус: 200
{
"result": {
"block": {
"name": "Форма на светлом фоне по центру",
"section": [
"forms"
],
"dynamic": false,
"subtype": "form",
"attrsFormDescription": "<a href=\"/crm/webform/\" target=\"_blank\">Настроить CRM-формы</a>"
},
"nodes": {
"#wrapper": {
"type": "styleimg",
"code": "#wrapper"
}
},
"style": {
"block": {
"type": [
"block-default",
"block-border"
]
},
"nodes": {
".bitrix24forms": {
"type": "crm-form"
}
}
},
"assets": {
"css": [],
"js": [],
"ext": [
"landing_form"
],
"class": [],
"callbacks": []
},
"timestamp": 1751467642,
"callbacks": {
"afteradd": {}
},
"attrs": {
".bitrix24forms": [
{
"name": "Embed form flag",
"attribute": "data-b24form-embed",
"type": "string",
"hidden": true
},
{
"name": "Form design",
"attribute": "data-b24form-design",
"type": "string",
"hidden": true
},
{
"name": "Form from connector flag",
"attribute": "data-b24form-connector",
"type": "string",
"hidden": true
},
{
"name": "CRM-форма",
"attribute": "data-b24form",
"items": [
{
"name": "Форма обратной связи",
"value": "#crmFormInline3"
},
{
"name": "Контактные данные с комментарием",
"value": "#crmFormInline39"
}
],
"type": "list"
},
{
"name": "Дизайн формы",
"attribute": "data-b24form-use-style",
"type": "list",
"items": [
{
"name": "Использовать дизайн блока",
"value": "Y"
},
{
"name": "Использовать дизайн CRM-формы",
"value": "N"
}
]
}
]
},
"cards": [],
"menu": [],
"namespace": "bitrix",
"code": "33.13.form_2_light_no_text",
"preview": "/bitrix/blocks/bitrix/33.13.form_2_light_no_text/preview.jpg"
},
"time": {
"start": 1774521323,
"finish": 1774521323.212432,
"duration": 0.2124319076538086,
"processing": 0,
"date_start": "2026-03-26T13:35:23+03:00",
"date_finish": "2026-03-26T13:35:23+03:00",
"operating_reset_at": 1774521923,
"operating": 0
}
}
Возвращаемые данные
|
Название |
Описание |
|
result |
Подготовленный манифест блока (подробное описание). Общий формат манифеста описан в статье Файл манифеста. Пустые разделы манифеста могут вернуться как пустые массивы |
|
time |
Информация о времени выполнения запроса |
Объект result
|
Название |
Описание |
|
block |
Основные свойства блока из манифеста (подробное описание) |
|
cards |
Описание карточек блока, если они есть. Если карточек нет, может вернуться пустой массив |
|
nodes |
Описание редактируемых узлов блока. Для каждого узла метод дополнительно добавляет ключ Для узлов с отдельным обработчиком в редакторе метод также добавляет ключ |
|
attrs |
Описание настраиваемых атрибутов блока, если они есть. Если атрибутов нет, может вернуться пустой массив |
|
menu |
Описание меню блока, если оно есть. Если меню нет, может вернуться пустой массив |
|
style |
Описание доступных настроек стилей блока. Если в исходном манифесте стили не разделены на |
|
namespace |
Пространство имен блока. Для встроенных блоков Битрикс24 обычно это |
|
code |
Код блока |
|
preview |
Относительный путь к файлу предпросмотра Если файл предпросмотра отсутствует, вернется пустая строка. Для блоков, зарегистрированных через REST API или приложение, это поле возвращает пустую строку |
|
assets |
Ресурсы блока (подробное описание) |
|
timestamp |
Время обновления базового манифеста в формате Unix Timestamp. Для локального блока это время изменения файла |
|
callbacks |
Callback-обработчики из манифеста блока. Названия обработчиков метод приводит к нижнему регистру |
В result могут быть и другие ключи исходного манифеста. Их состав зависит от конкретного блока.
Объект block
|
Название |
Описание |
|
name |
Название блока |
|
section |
Разделы, к которым относится блок |
|
dynamic |
Признак динамического блока |
|
Подтип блока, если он задан |
В объекте block могут быть и другие поля манифеста. Их набор зависит от конкретного блока.
Объект assets
|
Название |
Описание |
|
css |
Список CSS-ресурсов блока. Сюда попадают пути из манифеста и автоматически найденный локальный Для дизайнерских локальных блоков вместо |
|
js |
Список JS-ресурсов блока. Сюда попадают пути из манифеста и автоматически найденный локальный |
|
ext |
Список клиентских расширений блока. Для REST-блоков метод возвращает только расширения из разрешенного списка |
|
class |
Служебные пути к PHP-классам блока на сервере. Для большинства обычных вызовов массив пуст или не нужен клиентскому коду |
|
callbacks |
Список callback-функций из секции В отличие от |
Обработка ошибок
HTTP-статус: 400
{
"error": "BLOCK_NOT_FOUND",
"error_description": "Блок не найден"
}
|
Название |
Описание |
|
error |
Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания |
|
error_description |
Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде |
Возможные коды ошибок
|
Код |
Описание |
|
|
Не передан обязательный параметр |
|
|
У пользователя нет права на просмотр страницы |
|
|
Страница с идентификатором |
|
|
Блок с идентификатором |
Статусы и коды системных ошибок
HTTP-статус: 20x, 40x, 50x
Описанные ниже ошибки могут возникнуть при вызове любого метода
|
Статус |
Код |
Описание |
|
|
|
Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24 |
|
|
|
Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24 |
|
|
|
Превышен лимит на интенсивность запросов |
|
|
|
Текущий метод не разрешен для вызова с помощью batch |
|
|
|
Превышена максимальная длина параметров, переданных в метод batch |
|
|
|
Неверный access-токен или код вебхука |
|
|
|
Для вызовов методов требуется использовать протокол HTTPS |
|
|
|
REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24 |
|
|
|
REST API доступен только на коммерческих планах |
|
|
|
У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав |
|
|
|
Манифест недоступен |
|
|
|
Запрос требует более высоких привилегий, чем предоставляет токен вебхука |
|
|
|
Предоставленный access-токен доступа истек |
|
|
|
Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям |
|
|
|
Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта |
Продолжите изучение
- Получить контент блока `landing.block.getcontent`
- Получить список блоков страницы `landing.block.getlist`
- Получить блок по идентификатору `landing.block.getbyid`
- Получить файл манифеста блока landing.block.getmanifestfile