метод REST scope: landing

landing.role.getList

Получить список ролей

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

Описание

Метод landing.role.getList получает список ролей доступа для выбранного типа сайтов.

Параметры

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

Тип сайтов, для которого нужно получить роли. Параметр не связан с REST-скоупом landing в названии метода.

Значения GROUP, KNOWLEDGE и MAINPAGE соответствуют типам сайтов из статьи Работа с типами сайтов и скоупами.

Возможные значения:
GROUP - роли для сайтов групп
KNOWLEDGE - роли для баз знаний
MAINPAGE - роли для главной страницы или вайба

По умолчанию метод возвращает роли для сайтов и интернет-магазинов. Так будет, если параметр не передать или указать неподдерживаемое значение

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "KNOWLEDGE"
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.role.getList.json"

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "ID": "3",
            "TITLE": "Администратор",
            "XML_ID": "ADMIN"
        },
        {
            "ID": "5",
            "TITLE": "Менеджер",
            "XML_ID": "MANAGER"
        }
    ],
    "time": {
        "start": 1775062049,
        "finish": 1775062049.634052,
        "duration": 0.634052038192749,
        "processing": 0,
        "date_start": "2026-04-01T19:47:29+03:00",
        "date_finish": "2026-04-01T19:47:29+03:00",
        "operating_reset_at": 1775062649,
        "operating": 0
    }
}

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

result object[]

Список ролей выбранного типа сайтов (подробное описание).

Если роли не найдены, метод возвращает result: []

time time

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

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

HTTP-статус: 400

{
    "error": "IS_NOT_ADMIN",
    "error_description": "Для совершения действия необходимо быть администратором."
}
Код Описание Значение
ACCESS_DENIED Нет авторизации или недостаточно прав для работы с модулем «Сайты и магазины»
IS_NOT_ADMIN Для метода нужны права администратора или право «полный доступ» к разделу «Сайты и магазины»
FEATURE_NOT_AVAIL На текущем тарифе недоступно управление правами в разделе «Сайты и магазины»

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

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