Команда и доступ
Раздел про людей и технические учётные записи внутри проекта: кто входит в платформу, что ему разрешено и как это настраивается. Клиенты сюда не относятся — они живут в CRM, а вход клиента на витрину описан в клиентском API.
Страницы раздела
| Задача | Страница |
|---|---|
| Вход сотрудника и получение Bearer | доступ сотрудников |
| Заведение сотрудников, роли, привязка к бизнесу | сотрудники и менеджеры |
| Подключение внутреннего сервиса | инструкция на этой странице |
| Справочник прав, ролей и системных значений | справочники и права |
| Меню интерфейса платформы для сотрудников | меню сотрудников |
Как выдаётся доступ
Проект ──> сотрудник ──> роль ──> permissions
│
├── бизнес и подразделение: что видно в интерфейсе
└── Bearer после входа: чем подписаны запросы- Сотрудника заводят в проекте и назначают роль — контракт в сотрудниках.
- Одноразовый пароль приходит по
POST /api/send_password, вход —POST /api/login. GET /api/userвозвращает текущего сотрудника вместе с ролью и правами: с этого запроса удобно начинать отладку доступа.
Внутренний сервис
Для интеграции создавайте отдельную техническую учётную запись User, а не используйте личный токен сотрудника.
- Создайте пользователя в нужном проекте.
- Выдайте минимальную роль и только необходимые права (
permissions). - Получите User Bearer через обычный вход сотрудника.
- Проверьте подключение запросом
GET /api/user. - Храните Bearer на сервере и не передавайте его в публичную клиентскую витрину.
Разным интеграциям с разными полномочиями нужны отдельные учётные записи. Дополнительный токен той же записи не создаёт новый набор прав.
Что важно знать про права
- Права проверяются не везде. Часть методов платформы закрыта политиками и сверяет проект, часть — нет. Где именно проверка есть, написано на страницах самих методов; при автоматизации не считайте Bearer гарантией изоляции.
- Агент — не сотрудник. Парольный вход для агентских учётных записей закрыт:
send_passwordиloginотвечают403. Токены агентов выдаются иначе — см. Агентский доступ. - User Bearer — серверный секрет. Во фронтенд публичной витрины он не попадает: витрина работает по App Token, клиент — по своему Bearer.
Дальше
- Агентские токены и профили доступа — Агентский доступ.
- Настройка продукта — интернет-магазин и приложения и бизнесы.
- Операционные данные — каталог, склад, CRM и CMS.