метод REST scope: landing

landing.block.getlist

Получить список блоков страницы

Кто может выполнять: пользователь с правом «просмотр» сайтов

Описание

Метод landing.block.getlist возвращает список блоков выбранной страницы.

Параметры

scope string необязательный

Внутренний скоуп лендингов. Он не связан с REST-скоупом landing в названии метода.

Значение scope должно соответствовать типу сайта (подробное описание)

lid integer обязательный

Идентификатор страницы или массив идентификаторов страниц.

Идентификаторы страниц можно получить методом landing.landing.getList

Если lid передан массивом, метод объединяет блоки всех указанных страниц в один список. В каждом элементе ответа есть поле lid, по которому можно определить страницу-источник.

Если передан массив и хотя бы одна страница не найдена или недоступна, весь вызов завершается ошибкой

params object необязательный

Дополнительные параметры чтения списка (подробное описание)

Параметр params

edit_mode boolean необязательный

Если значение приводится к true, метод читает черновик страницы вместо опубликованной версии.

По умолчанию — false. Без этого параметра метод читает только опубликованные блоки

deleted boolean необязательный

Если значение приводится к true, метод возвращает только блоки, помеченные как удаленные.

По умолчанию — false. Параметр влияет только на выборку блоков. Поиск удаленной страницы он не включает, поэтому для страницы из корзины метод вернет ошибку.

Чтобы получить удаленные блоки, передайте deleted: true вместе с edit_mode: true. Параметр deleted сам по себе не переключает метод на черновик.

Если не указать edit_mode, метод будет искать блоки только в опубликованной версии страницы

get_content boolean необязательный

Если передать true, метод добавит в каждый элемент результата поля content, css и js. По умолчанию — false.

Поле content содержит уже подготовленный HTML блока вместе с системным контейнером блока, а не исходное сохраненное содержимое.

Если edit_mode выключен, метод вернет HTML опубликованной версии блока.
Если edit_mode включен, метод вернет HTML черновика

Примеры запроса

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "lid": 4858,
    "params": {
      "edit_mode": true,
      "get_content": true
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.block.getlist.json"

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "id": 28181,
            "lid": 2215,
            "code": "0.menu_02",
            "name": "Меню с логотипом слева и пунктами меню справа",
            "active": true,
            "meta": {
                "LID": "2215",
                "FAVORITE_META": "Array",
                "CREATED_BY_ID": "779",
                "DATE_CREATE": "09/13/2024 10:28:08 am",
                "MODIFIED_BY_ID": "1295",
                "DATE_MODIFY": "03/26/2026 12:21:48 pm",
                "SITE_TYPE": "PAGE",
                "LANDING_TITLE": "",
                "LANDING_TPL_CODE": "bitrix.krayt_otdykh_na_prirode",
                "SITE_TPL_CODE": "empty",
                "XML_ID": "",
                "DESIGNER_MODE": ""
            },
            "content": "<div id=\"b2884\" class=\"block-wrapper block-0-menu-02\"><header class=\"landing-block u-header u-header--float u-header--sticky\">...</header></div>",
            "css": [],
            "js": []
        }
    ],
    "time": {
        "start": 1774521039,
        "finish": 1774521039.570632,
        "duration": 0.5706319808959961,
        "processing": 0,
        "date_start": "2026-03-26T13:30:39+03:00",
        "date_finish": "2026-03-26T13:30:39+03:00",
        "operating_reset_at": 1774521639,
        "operating": 0.48987889289855957
    }
}

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

result object[]

Список блоков (подробное описание).

Метод может вернуть result: [] без ошибки в трех случаях.

  • На странице нет блоков для выбранного режима чтения.
  • Страница еще не публиковалась и params.edit_mode не включен.
  • Фильтр deleted не нашел подходящих блоков
time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "LANDING_NOT_EXIST",
    "error_description": "Лендинг не найден"
}
Код Описание Значение
MISSING_PARAMS Не передан обязательный верхнеуровневый параметр lid
LANDING_NOT_EXIST Страница не найдена, удалена или недоступна текущему пользователю
ACCESS_DENIED У пользователя нет права на просмотр сайтов
TYPE_ERROR Внутренняя ошибка несоответствия типов при вызове метода
SYSTEM_ERROR Внутренняя ошибка при выполнении метода

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.