метод REST scope: landing

landing.landing.removeEntities

Удалить блоки и очистить файловые привязки изображений страницы

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

Описание

Метод landing.landing.removeEntities удаляет со страницы указанные блоки и связанные с ними изображения. Также с его помощью можно очистить файловые привязки у отдельных изображений без удаления самих блоков.

Параметры

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

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

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

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

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

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

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

Набор объектов для удаления (подробное описание).

Если не указать блоки или изображения для удаления, страница останется без изменений. При этом метод все равно вернет true, если страница существует

Параметр data

blocks integer[] необязательный

Идентификаторы блоков страницы, которые нужно удалить полностью.

Для каждого блока метод также удаляет все связанные изображения.

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

images object[] необязательный

Пары идентификаторов блока и изображения для удаления файловой привязки. Содержимое блока не изменяется — используйте, когда изображение уже убрано из блока и нужно очистить оставшуюся служебную запись. (подробное описание).

Метод не вернет отдельную ошибку в трех случаях: если блок не найден, если он уже указан в параметре blocks или если изображение не связано с этим блоком

Параметр images

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

Идентификатор блока, с которым связана файловая привязка изображения

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

Внутренний идентификатор файловой привязки изображения (FILE_ID), связанной с блоком block.

Для существующих изображений FILE_ID можно получить методом landing.block.getcontent. В ответе нужно найти HTML блока в поле content и посмотреть значение атрибута data-fileid у нужного изображения

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "lid": 648,
    "data": {
      "blocks": [12167, 123],
      "images": [
        {
          "block": 12269,
          "image": 6866
        },
        {
          "block": 12268,
          "image": 6861
        }
      ]
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.landing.removeEntities.json"

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1773796328,
        "finish": 1773796328.413521,
        "duration": 0.41352105140686035,
        "processing": 0,
        "date_start": "2026-03-18T04:12:08+03:00",
        "date_finish": "2026-03-18T04:12:08+03:00",
        "operating_reset_at": 1773796928,
        "operating": 0
    }
}

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

result boolean

Результат удаления, при успехе возвращается true

time time

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

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

HTTP-статус: 400

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

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

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