метод REST scope: landing

landing.role.setRights

Установить права роли для списка сайтов

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

Описание

Метод landing.role.setRights устанавливает права роли по сайтам. Для каждого сайта можно задать отдельные права, а для остальных — общие права по умолчанию. Новый набор прав полностью заменяет предыдущий.

Параметры

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

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

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

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

Если параметр не передать, метод работает с ролями для сайтов и интернет-магазинов. Для роли другого раздела метод вернет ошибку ROLE_SCOPE_MISMATCH

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

Идентификатор роли, для которой нужно обновить права.

Получить идентификатор можно с помощью метода landing.role.getList.

Если передать идентификатор несуществующей роли, метод вернет ошибку ROLE_SCOPE_MISMATCH

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

Объект формата:

{
    "0": ["read"],
    "<siteId>": ["read", "edit", "sett"]
}

где:
- 0 — право по умолчанию для сайтов без отдельной настройки
- <siteId> — идентификатор сайта

Список доступных кодов прав описан ниже, а структура объекта — в таблице параметра rights.

Метод полностью заменяет ранее сохраненные права роли по сайтам

additional string[] необязательный

Дополнительные возможности роли.

Возможные значения:

  • menu24 — показывать для роли пункт меню раздела
  • create — разрешить создавать в разделе новые сайты, базы знаний или страницы

Коды зависят от раздела из параметра scope. Для баз знаний, сайтов групп и главной страницы у кодов есть префикс — knowledge_, group_ и vibe_ соответственно. Например, для базы знаний нужно передать knowledge_create.

Коды другого раздела метод не сохраняет.

Если параметр не передавать, текущие дополнительные возможности роли сохранятся без изменений

Параметр rights

0 string[] необязательный

Права роли по умолчанию для всех сайтов, у которых нет отдельной настройки.

Доступные коды прав описаны ниже

<siteId> string[] необязательный

Права роли для сайта с указанным идентификатором.

Ключом служит идентификатор сайта, значением — массив кодов прав. Если сайт с таким идентификатором не найден, запись будет пропущена без ошибки.

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

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

Коды прав

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

Доступ к сайту запрещен

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

Просмотр сайта

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

Изменение страниц сайта

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

Изменение настроек сайта

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

Публикация

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

Удаление в корзину и восстановление из корзины

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "id": 11,
    "rights": {
      "0": ["read"],
      "66": ["read", "edit", "sett"],
      "71": ["denied"]
    },
    "additional": ["menu24", "create"]
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.role.setRights.json"

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1775071662,
        "finish": 1775071663.148474,
        "duration": 1.1484739780426025,
        "processing": 0,
        "date_start": "2026-04-01T22:27:42+03:00",
        "date_finish": "2026-04-01T22:27:43+03:00",
        "operating_reset_at": 1775072263,
        "operating": 0.1147608757019043
    }
}

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

result boolean

Результат вызова.

Метод возвращает true, если запрос обработан без ошибки доступа или системной ошибки.

Значение true не гарантирует, что права были записаны для каждого переданного сайта. Если сайт не найден или формат одной из записей некорректен, такая запись будет пропущена без ошибки.

После вызова проверьте сохраненный набор прав методом landing.role.getRights

time time

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

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

HTTP-статус: 400

{
    "error": "MISSING_PARAMS",
    "error_description": "Недостаточно параметров вызова, пропущены: rights"
}
Код Описание Значение
ACCESS_DENIED Недостаточно прав для работы с разделом «Сайты и магазины»
IS_NOT_ADMIN Для метода нужны права администратора или право «полный доступ» к разделу «Сайты и магазины»
FEATURE_NOT_AVAIL Управление правами в разделе «Сайты и магазины» недоступно на текущем тарифе
MISSING_PARAMS Не передан обязательный параметр id или rights
ROLE_SCOPE_MISMATCH Роль не относится к разделу из параметра scope. Метод возвращает эту ошибку и для роли другого раздела, и для несуществующей роли

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

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