метод REST scope: landing

landing.block.getbyid

Получить блок по идентификатору

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

Описание

Метод landing.block.getbyid возвращает один блок страницы по его идентификатору.

Параметры

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

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

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

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

Идентификатор блока.

Идентификатор блока можно получить методом landing.block.getlist

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

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

Параметр params

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

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

По умолчанию — false

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

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

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

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

Если значение приводится к true, в result дополнительно возвращаются поля content, css и js.

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

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

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

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 39556,
        "lid": 4858,
        "code": "01.big_with_text",
        "name": "Блок с текстом и изображением",
        "active": true,
        "meta": {
            "LID": "2215",
            "FAVORITE_META": "Array",
            "CREATED_BY_ID": "1295",
            "DATE_CREATE": "03/26/2026 11:27:24 am",
            "MODIFIED_BY_ID": "1295",
            "DATE_MODIFY": "03/26/2026 12:23:02 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=\"b28853\" class=\"block-wrapper block-18-2-two-cols-fix-img-text-button-with-cards\"><section class=\"landing-block g-pt-30 g-pb-30 g-bg-transparent\">...</section></div>",
        "css": [],
        "js": []
    },
    "time": {
        "start": 1774521156,
        "finish": 1774521157.330784,
        "duration": 1.3307840824127197,
        "processing": 1,
        "date_start": "2026-03-26T13:32:36+03:00",
        "date_finish": "2026-03-26T13:32:37+03:00",
        "operating_reset_at": 1774521756,
        "operating": 0.3684520721435547
    }
}

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

result object

Данные найденного блока (подробное описание)

Метод не возвращает result: []. Если блок не найден в выбранной версии страницы, метод завершается ошибкой

time time

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

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

HTTP-статус: 400

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

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

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