метод REST scope: landing

landing.syspage.getSpecialPage

Получить адрес специальной страницы сайта

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

Описание

Метод landing.syspage.getSpecialPage возвращает URL специальной страницы сайта.

Параметры

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

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

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

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

Код специальной страницы, который метод ищет в привязках сайта.

Метод ищет точное совпадение по строке, без обрезки пробелов и без нормализации регистра.

Возможные значения:
- mainpage — главная страница
- catalog — главная страница каталога
- personal — персональный раздел
- cart — корзина
- order — оформление заказа
- payment — страница оплаты
- compare — страница сравнения
- feedback — страница обратной связи

Метод landing.syspage.set при сохранении убирает пробелы по краям значения type. Поэтому в landing.syspage.getSpecialPage параметр type нужно передавать без лишних пробелов. Иначе метод может не найти нужную страницу.

Если вместо строки передать число, true, false или null, метод вернет пустую строку "". Если передать массив, запрос завершится ошибкой

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

Дополнительные параметры URL (подробное описание).

Каждая пара ключ-значение добавляется к итоговому URL найденной страницы. По умолчанию — пустой объект

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "siteId": 1390,
    "type": "personal",
    "additional": {
      "SECTION": "private"
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.syspage.getSpecialPage.json"

Ответ

HTTP-статус: 200

{
    "result": "https://btest.bitrix24.shop/personalnyyrazdel/?SECTION=private",
    "time": {
        "start": 1774359422,
        "finish": 1774359422.588757,
        "duration": 0.5887570381164551,
        "processing": 0,
        "date_start": "2026-03-24T16:37:02+03:00",
        "date_finish": "2026-03-24T16:37:02+03:00",
        "operating_reset_at": 1774360022,
        "operating": 0
    }
}

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

result string

URL специальной страницы.

Если передан additional и страница найдена, параметры будут добавлены в строку запроса.

Метод не проверяет, активна ли страница и не помечена ли она как удаленная. Возвращает null, если сайт не найден или у пользователя нет права «чтение» сайта siteId.

Пустая строка "" возвращается в двух случаях:
- если для переданного type не найдена привязка,
- если type передан не строкой и не массивом

time time

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

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

HTTP-статус: 400

{
    "error": "MISSING_PARAMS",
    "error_description": "Недостаточно параметров вызова, пропущены: type"
}
Код Описание Значение
MISSING_PARAMS Не передан обязательный параметр siteId, type или оба параметра
ACCESS_DENIED Доступ к вызову метода запрещен: недостаточно прав для работы с разделом Сайты и магазины
ERROR_ARGUMENT Передан неверный тип данных в параметре siteId, type или additional
SYSTEM_ERROR Во время выполнения метода возникла внутренняя ошибка

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

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