метод REST scope: landing

landing.site.addFolder

Добавить папку в сайт

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

Описание

Метод landing.site.addFolder создает папку в указанном сайте и возвращает идентификатор созданной папки.

Параметры

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

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

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

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

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

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

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

Набор полей создаваемой папки (подробное описание)

Параметр fields

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

Название папки, максимальная длина 255 символов

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

Символьный код папки для URL, максимальная длина 255 символов. Если не передан или пустой, код создается из TITLE транслитерацией.

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

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

Идентификатор родительской папки. Если значение 0, null или пустое, папка создается в корне сайта

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

Флаг активности папки Y/N, по умолчанию N

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "siteId": 1817,
    "fields": {
      "TITLE": "Новая папка",
      "CODE": "new-folder",
      "ACTIVE": "Y",
      "PARENT_ID": 736
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.site.addFolder.json"

Ответ

HTTP-статус: 200

{
    "result": 89,
    "time": {
        "start": 1773169396,
        "finish": 1773169396.875899,
        "duration": 0.875899076461792,
        "processing": 0,
        "date_start": "2026-03-10T22:03:16+03:00",
        "date_finish": "2026-03-10T22:03:16+03:00",
        "operating_reset_at": 1773169996,
        "operating": 0
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error": "ACCESS_DENIED",
    "error_description": "Сайт не найден или доступ к нему запрещен."
}
Код Описание Значение
ACCESS_DENIED Сайт не найден или доступ к нему запрещен
BX_EMPTY_REQUIRED Не заполнено обязательное поле, например TITLE или CODE
FOLDER_IS_NOT_UNIQUE С таким именем уже определена папка. Ошибка возникает при конфликте CODE в пределах сайта и родительской папки
SLASH_IS_NOT_ALLOWED В fields.CODE передан символ /

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

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