метод REST scope: landing

landing.landing.update

Изменить страницу

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

Описание

Метод landing.landing.update обновляет параметры страницы.

Параметры

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

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

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

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

Набор полей страницы для обновления (подробное описание)

Параметр fields

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

Название страницы

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

Символьный код страницы. Код не может содержать символ / и не должен быть в формате <буквы, цифры или _>_<число>_<число>, например code_12_34.

Если передать пустую строку и не указать поле FOLDER, метод вернет ошибку. Если поле FOLDER передано с любым значением, ошибки не будет

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

Произвольное описание страницы

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

Внешний идентификатор страницы

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

Идентификатор сайта, к которому нужно привязать страницу. Если параметр не передан, используется текущий сайт страницы.

Если одновременно указать новый сайт и папку, папка будет проверяться не в новом, а в текущем сайте страницы. Для такого сценария лучше использовать landing.landing.move

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

Флаг включения страницы в карту сайта. Поддерживаются значения Y и N. Любое другое значение будет сохранено как N

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

Признак папки. Поддерживаются значения Y и N. Любое другое значение будет сохранено как N

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

Идентификатор папки, в которую нужно поместить страницу. Папка должна находиться в текущем сайте страницы. Если передать 0, страница будет перенесена в корень сайта.

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

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

Идентификатор шаблона представления страницы.

Идентификатор шаблона представления можно получить методом landing.template.getlist

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

Управляет состоянием страницы в корзине. При передаче этого поля страница становится неактивной.

Y — страница помещается в корзину и становится неактивной.
N — страница восстанавливается из корзины, но остается неактивной, пока ее не опубликуют отдельно.

Для удаления и восстановления страницы лучше использовать методы landing.landing.markDelete и landing.landing.markUnDelete.

Если страница установлена главной в настройках сайта и в этом сайте есть другие неудаленные страницы, метод вернет ошибку CANT_DELETE_MAIN

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

Дата и время публикации страницы.

Для изменения этого поля нужно право «публикация» на сайт. Изменение поля не публикует страницу, а только обновляет дату публикации.

Для публикации и снятия с публикации используйте методы landing.landing.publication и landing.landing.unpublic

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

Дополнительные поля страницы. Доступные коды и значения описаны в статье Дополнительные поля страницы

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "lid": 349,
    "fields": {
      "TITLE": "Весенняя акция 2026",
      "CODE": "spring-sale-2026",
      "DESCRIPTION": "Обновленное описание страницы акции",
      "XML_ID": "promo-2026-landing"
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.landing.update.json"

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1773835076,
        "finish": 1773835076.29,
        "duration": 0.28999996185302734,
        "processing": 0,
        "date_start": "2026-03-18T14:57:56+03:00",
        "date_finish": "2026-03-18T14:57:56+03:00",
        "operating_reset_at": 1773835676,
        "operating": 0.1001579761505127
    }
}

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

result boolean

Результат обновления. При успехе возвращается true

time time

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

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

HTTP-статус: 400

{
    "error": "MISSING_PARAMS",
    "error_description": "Недостаточно параметров вызова, пропущены: lid"
}
Код Описание Значение
MISSING_PARAMS Не передан обязательный параметр lid или fields
ACCESS_DENIED Недостаточно прав для изменения страницы или конкретного поля. Например, для fields.DELETED нужно право «удаление» сайта, а для fields.DATE_PUBLIC нужно право «публикация» сайта
SITE_NOT_FOUND В fields.SITE_ID передан идентификатор несуществующего сайта
FOLDER_NOT_FOUND В fields.FOLDER_ID передана папка, которая не относится к текущему сайту страницы или не существует
SLASH_IS_NOT_ALLOWED В fields.CODE передан символ /
CANT_BE_EMPTY В fields.CODE передана пустая строка '', и в том же запросе отсутствует ключ fields.FOLDER
WRONG_CODE_FORMAT В fields.CODE передано значение в формате <буквы, цифры или _>_<число>_<число>, например code_12_34 или my_page_1_2
CANT_DELETE_MAIN Нельзя пометить как удаленную главную страницу сайта, если в сайте есть другие неудаленные страницы
TYPE_ERROR Ошибка типа данных в параметрах вызова метода
SYSTEM_ERROR Внутренняя ошибка при выполнении метода

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

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