метод REST scope: landing

landing.landing.favoriteBlock

Сохранить в список блоков

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

Описание

Метод landing.landing.favoriteBlock создает копию блока страницы и сохраняет ее в список блоков как шаблон. При успешном выполнении метод возвращает идентификатор новой копии блока.

Параметры

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

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

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

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

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

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

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

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

Идентификатор блока можно получить методом landing.block.getList с параметром params.edit_mode = 1

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

Параметры сохраненного блока (подробное описание).

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

Параметр meta

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

Название сохраненной копии блока в списке блоков.

Это пользовательское название сохраненной копии. Оно не заменяет стандартное название блока. Если параметр не передан, используется исходное название блока

section array необязательный

Раздел или список разделов, в которых будет показан сохраненный блок. Если параметр не передан, блок будет показан в тех же разделах, что и исходный блок.

Можно использовать коды разделов из метода landing.block.getrepository. Если передать код, которого нет в стандартном репозитории, для него будет создан отдельный раздел

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

Идентификатор файла картинки превью.

Передайте ID файла с картинкой, заранее загруженного методом landing.block.uploadfile для исходного блока. Метод сохраняет этот ID как превью сохраненной копии блока.

Если файл уже привязан к исходному блоку как пользовательское превью, эта привязка изменится только после успешного завершения метода. Если метод завершится ошибкой, привязка к исходному блоку не изменится. Если параметр не передан или равен 0, пользовательское превью не сохраняется

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

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

Передача этого параметра эквивалентна включенному чекбоксу «Привязать к текущему стилю» в редакторе. Значение можно взять из поля TPL_CODE страницы, например из ответа метода landing.landing.getList.

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

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "lid": 351,
    "block": 6428,
    "meta": {
      "name": "Блок с преимуществами",
      "section": ["text", "features"],
      "preview": 918273,
      "tpl_code": "bitrix24"
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.landing.favoriteBlock.json"

Ответ

HTTP-статус: 200

{
    "result": 28619,
    "time": {
        "start": 1773958609,
        "finish": 1773958609.566006,
        "duration": 0.5660059452056885,
        "processing": 0,
        "date_start": "2026-03-20T01:16:49+03:00",
        "date_finish": "2026-03-20T01:16:49+03:00",
        "operating_reset_at": 1773959209,
        "operating": 0.21611928939819336
    }
}

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

result integer

Идентификатор сохраненной копии блока

time time

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

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

HTTP-статус: 400

{
    "error": "BLOCK_NOT_FOUND",
    "error_description": "Блок не найден в лендинге"
}
Код Описание Значение
MISSING_PARAMS Не передан обязательный параметр lid или block
TYPE_ERROR Передан неверный тип в параметре lid, block или meta
LANDING_NOT_EXIST Страница не найдена или недоступна текущему пользователю. Ошибка может относиться как к странице lid, так и к странице, которой принадлежит копируемый блок
BLOCK_NOT_FOUND Блок с идентификатором block не найден среди блоков исходной страницы или недоступен для копирования. Если не найдена страница, которой принадлежит блок, метод обычно возвращает LANDING_NOT_EXIST
BLOCK_CANT_BE_ADDED Не удалось создать копию блока в репозитории блоков
BLOCK_WRONG_VERSION Версия блока не поддерживается текущей версией продукта
ACCESS_DENIED Недостаточно прав на изменение блока

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

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