метод REST scope: landing

landing.landing.add

Добавить страницу или папку

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

Описание

Метод landing.landing.add добавляет страницу или папку в указанный сайт и возвращает идентификатор созданного объекта. Новый объект создается неактивным (ACTIVE = N).

Параметры

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

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

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

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

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

Параметр fields

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

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

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

Идентификатор сайта, в котором создается страница.

Идентификатор сайта можно получить методом landing.site.getList или из результата метода landing.site.add

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

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

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

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

Если после создания такой код уже используется в пределах сайта или папки, к нему добавится суффикс вида _<4 случайных символа>

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

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

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

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

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

Флаг включения страницы в карту сайта. Поддерживаются Y и N, по умолчанию N

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

Используется, если вместо страницы нужно создать папку. Поддерживаются Y и N, по умолчанию N

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

Идентификатор папки, в которой нужно создать страницу. Папка должна принадлежать тому же сайту, что и SITE_ID.

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

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

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

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

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

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

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

Вместе с MENU_CODE используется, чтобы после создания страницы добавить ссылку в меню блока с указанным идентификатором

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

Вместе с BLOCK_ID указывает код меню в блоке, куда нужно добавить ссылку на созданную страницу

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "fields": {
      "TITLE": "Весенняя акция",
      "SITE_ID": 292,
      "CODE": "spring-sale",
      "DESCRIPTION": "Страница для сезонной акции",
      "ADDITIONAL_FIELDS": {
        "THEME_CODE": "wedding"
      }
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.landing.add.json"

Ответ

HTTP-статус: 200

{
    "result": 2227,
    "time": {
        "start": 1773694924,
        "finish": 1773694924.307754,
        "duration": 0.3077540397644043,
        "processing": 0,
        "date_start": "2026-03-17T00:02:04+03:00",
        "date_finish": "2026-03-17T00:02:04+03:00",
        "operating_reset_at": 1773695524,
        "operating": 0
    }
}

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

result integer

Идентификатор созданной страницы или папки

time time

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

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

HTTP-статус: 400

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

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

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