метод REST scope: landing

landing.site.update

Изменить сайт

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

Описание

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

Параметры

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

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

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

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

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

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

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

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

Параметр fields

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

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

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

Символьный код сайта. При передаче пустой строки код генерируется из TITLE или из строки site.

Код не может содержать /, код из одних цифр получает префикс site, максимальная длина кода 253 символа.

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

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

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

Это внутренний тип лендинга, он связан с внутренним scope (подробное описание)

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

Домен сайта. Обычно передают доменное имя. Для сайтов типов PAGE, STORE, SMN, если параметр не передан или передана пустая строка, значение параметра игнорируется. Для GROUP, KNOWLEDGE и MAINPAGE параметр обычно не передают.

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

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

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

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

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

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

Идентификатор страницы сайта, которая будет главной

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

Идентификатор страницы ошибки 404

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

Идентификатор страницы ошибки 503

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "id": 206,
    "fields": {
      "TITLE": "Support portal",
      "CODE": "support-portal",
      "DESCRIPTION": "Обновленное описание сайта",
      "LANDING_ID_INDEX": 987
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.site.update.json"

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1773288229,
        "finish": 1773288229.999823,
        "duration": 0.9998230934143066,
        "processing": 0,
        "date_start": "2026-03-12T07:03:49+03:00",
        "date_finish": "2026-03-12T07:03:49+03:00",
        "operating_reset_at": 1773288829,
        "operating": 0
    }
}

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

result boolean

true, если сайт успешно обновлен

time time

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

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

HTTP-статус: 400

{
    "error": "MISSING_PARAMS",
    "error_description": "Недостаточно параметров вызова, пропущены: id"
}
Код Описание Значение
MISSING_PARAMS Не передан обязательный параметр id или fields
ACCESS_DENIED Недостаточно прав для изменения сайта или конкретных полей
DOMAIN_NOT_FOUND Указан несуществующий домен
DOMAIN_IS_INCORRECT Передан некорректный формат доменного имени
DOMAIN_EXIST_TRASH Домен уже привязан к сайту в корзине
DOMAIN_DISABLE Нельзя использовать запрещенное имя домена в Битрикс24
DOMAIN_EXIST Домен уже занят
CODE_IS_NOT_UNIQUE Код сайта не уникален в рамках домена
SLASH_IS_NOT_ALLOWED В fields.CODE передан символ /
CONTROLLER_ERROR_BADRESPONSE Неопознанный ответ внешнего сервиса регистрации домена
CONTROLLER_ERROR_BADLICENSE Ошибка лицензии во внешнем сервисе регистрации домена
CONTROLLER_ERROR_<ERROR_CODE> Ошибка внешнего сервиса регистрации домена с кодом <ERROR_CODE>

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

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