метод REST scope: landing

landing.site.add

Добавить сайт

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

Описание

Метод landing.site.add создает новый сайт и возвращает идентификатор созданного сайта.

Параметры

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

Внутренний скоуп лендингов. Он не связан с REST-скоупом landing в названии метода.
Для GROUP, KNOWLEDGE и MAINPAGE значение scope должно совпадать со значением fields.TYPE (подробное описание)

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

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

Параметр fields

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

Название сайта, длина до 255 символов

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

Символьный код сайта. Если передать пустую строку, код сгенерируется из поля TITLE. Для кода, который состоит только из цифр, автоматически добавится префикс site.

Если такое значение уже есть в домене, к нему добавится числовой суффикс, например code2 или code3

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

Тип сайта. По умолчанию PAGE. Поддерживаются PAGE, STORE, SMN, KNOWLEDGE, GROUP, MAINPAGE.

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

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

Домен сайта. Значение зависит от платформы.

Для Битрикс24 укажите доменное имя сайта. Если параметр не заполнить или передать пустую строку, домен будет сгенерирован автоматически по системному шаблону.

Для 1С-Битрикс: Управление сайтом нужно передать идентификатор уже существующего домена. Доменное имя в виде строки не поддерживается, метод вернет ошибку

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

Описание сайта, до 255 символов

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

Внешний идентификатор, до 255 символов

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

Дополнительные поля сайта, сохраняются отдельно после создания

Соответствие TYPE и scope

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

scope в запросе

PAGE, STORE, SMN необязательный

не передавать

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

GROUP

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

KNOWLEDGE

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

MAINPAGE

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "KNOWLEDGE",
    "fields": {
      "TITLE": "База знаний компании",
      "CODE": "",
      "TYPE": "KNOWLEDGE",
      "DESCRIPTION": "Сайт базы знаний"
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.site.add.json"

Ответ

HTTP-статус: 200

{
    "result": 159,
    "time": {
        "start": 1773161828,
        "finish": 1773161828.444154,
        "duration": 0.4441540241241455,
        "processing": 0,
        "date_start": "2026-03-10T19:57:08+03:00",
        "date_finish": "2026-03-10T19:57:08+03:00",
        "operating_reset_at": 1773162428,
        "operating": 0.14034819602966309
    }
}

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

result integer

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

time time

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

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

HTTP-статус: 400

{
    "error": "DOMAIN_IS_INCORRECT",
    "error_description": "Адрес сайта введен неверно. Вы можете использовать только следующие символы: \"a-z\", \"0-9\", \"-\", \".\"."
}
Код Описание Значение
ACCESS_DENIED Доступ на создание сайта запрещен: недостаточно прав на создание сайта или передан недоступный для текущего скоупа TYPE
SITE_LIMIT_REACHED Достигнут лимит количества сайтов: тариф или лицензия не позволяют создать еще один сайт
DOMAIN_NOT_FOUND Домен не существует
DOMAIN_IS_INCORRECT Адрес сайта введен неверно: передан некорректный формат доменного имени
DOMAIN_EXIST_TRASH Домен уже привязан к сайту в корзине: сначала отвяжите домен от сайта в корзине
DOMAIN_DISABLE Нельзя использовать слово bitrix в домене: ограничение для доменов в Битрикс24
DOMAIN_EXIST Такой домен уже существует: домен уже занят
SLASH_IS_NOT_ALLOWED Слеш запрещен в адресе сайта: в fields.CODE передан символ /
CONTROLLER_ERROR_BADRESPONSE Неопознанный ответ сервиса регистраций: ошибка внешнего сервиса регистрации домена
CONTROLLER_ERROR_BADLICENSE Лицензия истекла или ключ некорректен
CONTROLLER_ERROR_<ERROR_CODE> Ошибка внешнего сервиса регистрации домена: код ошибки зависит от ответа контроллера регистрации доменов

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

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