Перейти к содержимому

Права роли ключа

У каждого ключа интеграции есть своя роль — она создаётся вместе с ключом и видна в настройках компании. Её переключатели доступов меняют, что вернётся в ответе и какие операции пройдут внутри разрешённых маршрутов.

Запрос ключа проходит две независимые проверки.

Уровень 1 — маршрут Уровень 2 — право роли
Где проверяется на входе, до выполнения метода внутри метода, который отвечает на запрос
Что проверяет пара «HTTP-метод + шаблон пути» есть в списке маршрутов ключа конкретный переключатель доступа в роли ключа
Источник списка общий шаблон, одинаковый у всех компаний роль ключа, редактируется в интерфейсе
Если не прошло 403 access denied поле обнулено, фильтр сброшен или отказ по бизнес-правилу

При создании ключа его роль получает ровно два права:

Раздел → группа Право
Товары → Каталог Просмотр и поиск товаров в каталоге
Клиенты → Все клиенты Возможность просмотра списка клиентов

Каталог и клиенты входят в список маршрутов ключа, эти два переключателя на ответы не влияют. Все остальные сняты — из-за этого часть методов работает не полностью.

Карта: переключатель доступа → метод → что будет без него

Заголовок раздела «Карта: переключатель доступа → метод → что будет без него»

Ниже — все места, где право роли меняет поведение метода, доступного ключу.

Раздел → группа Право Метод ключа Что будет без права
Товары → Каталог Возможность просмотра цен поставки продуктов GET /v2/products в каждом товаре supply_price = 0, supply_currency = "" — и в корне, и внутри shop_prices
Товары → Каталог Возможность просмотра цен поставки продуктов POST /v2/product-search-with-filters фильтр по цене поставки молча сбрасывается: supply_price_from / supply_price_to обнуляются, выборка приходит нефильтрованной
Товары → Каталог Возможность просмотра остатка всех магазинов POST /v2/product-search-with-filters shop_ids из запроса игнорируется — выборка идёт только по магазинам, привязанным к ключу
Товары → Трансфер Возможность создавать трансферы POST /v2/transfer запрос будет принят, но черновик не создастся: асинхронный отказ 403, user has no permission to create transfer, код 2007
Товары → Заказы Возможность возврата заказа POST /v2/supplier-order с returned_supplier_order_id обычный заказ создастся, возврат — нет: асинхронный отказ 400, user has no permission to return supplier order, код 2029
Продажи → Новая продажа Возможность удалять отложки DELETE /v2/order/:id, если продажа отложена асинхронный отказ 400, no permission to delete parked order, код 20116; обычные продажи удаляются как раньше
  1. Настройки → Настройки компании → Ключи интеграции.

  2. Открыть роль нужного ключа.

    Список ключей интеграции: ссылка на роль ключа в колонке «Роль»

  3. Отметить требуемые действия в нужной секции и сохранить.

    Страница роли ключа: разделы слева, переключатели доступов справа

Права кэшируются на 20 минут; изменение роли сбрасывает кэш.