Рабочее пространство и люди
Кто спрашивает, что ему можно и кто ещё здесь есть.
Инструменты рабочего пространства и людей
| Инструмент | Что делает |
|---|---|
| whoAmI | Что вам можно делать в ящике, который сейчас активен: какую роль вы держите, владеете ли вы рабочим пространством и все разрешения, которые эта роль даёт. |
| listRoles | Роли, которые определяет это рабочее пространство, и что даёт каждая, со сколькими людьми и ключами API держат каждую, — тот факт, который говорит, безопасно ли её менять. |
| listWorkspaceMembers | Кто есть в рабочем пространстве, какую роль держит каждый из них и какие адреса им выданы. |
Прочитайте whoAmI, прежде чем говорить кому-то, что что-то сделать нельзя. Инструмента, на который у вас нет разрешения, в вашем списке инструментов нет ВООБЩЕ, поэтому отсутствующий инструмент куда чаще означает разрешение, которого у вас нет, чем функцию, которой у этого сервера нет. Он отвечает за АКТИВНОЕ подключение, поэтому после setActiveConnection ответ меняется.
whoAmI не требует разрешений; остальные два закрыты за roles:read и members:read. Разделение здесь то же, что и везде: описать себя — не высказывание о ком-то другом, а те два, что называют коллег, закрыты, как и любое другое высказывание о другом человеке.
РОЛЬ и ВЫДАЧА АДРЕСА — разные вещи, и listWorkspaceMembers сообщает и то и другое по каждому человеку, потому что ни одно не отвечает за другое. Роль — это что человеку можно делать, адреса — к чему он может это делать, и человек может держать роль без адресов (он откроет пустой ящик) или адрес вообще без строки роли — это более старая выдача, подразумевающая роль, а не выбранная кем-то. Владелец рабочего пространства не перечисляется: это учётная запись, которой принадлежит рабочее пространство, и он держит всё.
Ничто здесь не пишет. Нет ни createRole, ни setMemberRole, ни grantAddress — по той же причине, по которой нет deleteRule: расширение роли или раздача адреса из окна чата — тихое, широкое изменение, которого потом никто не видит. Всё это есть в разделе Настройки → Роли и на /roles, где тот, кто это делает, видит всю матрицу, которую меняет.