Работа с пользователями
Разрешение Пользователи (user)
Scope: user Права на выполнение: в зависимости от метода
Описание
Методы работы с пользователями Битрикс24 позволяют приглашать новых пользователей, изменять данные существующих пользователей и выбирать пользователей при помощи условий. Приложения, которые используют эти методы в своих сценариях, должны обеспечивать максимальную безопасность пользовательских данных и получать только ту информацию о пользователях, которая действительно необходима для работы приложения.
Чтобы гарантировать пользователям безопасность их персональной информации, существует несколько уровней доступа через методы работы с пользователями:
- Ограниченные версии доступа:
- user_brief, который позволяет получать базовую информацию о пользователях, без их контактных данных и пользовательских полей. Этот скоуп необходим и достаточен для сценариев, в которых требуется отобразить ФИО пользователя в интерфейсе приложения.
- user_basic, который позволяет получать не только базовую информацию, но и контактные данные пользователей Битрикс24. Этот скоуп нужен для сценариев, связанных с совершением звонков, или отправкой e-mail сообщений при помощи вашего приложения.
- Полные версии доступа:
- user, который позволяет получить все стандартные поля, а кроме того, делает доступной возможность приглашения новых пользователей и изменение данных существующих пользователей.
- user.userfield, который открывает доступ к методам для работы с пользовательскими полями пользователей (расширяет перечень доступных полей в методах чтения, доступных в скоупах выше) для получения, добавления, изменения и удаления пользовательских полей.
Внимание! Это максимальный уровень доступа к персональной информации, запрашивать его нужно очень ответственно.
Ограниченные версии скоупа user
В этих скоупах нельзя добавлять/обновлять пользователей: не доступны методы user.add и user.update. Во всех остальных методах получения информации о пользователе доступны только эти поля (с версии Rest 21.600.0):
user_basic | user_brief |
---|---|
|
|
* Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.
Полная версия скоупа user
В полной версии доступны поля (с версии Rest 21.600.0):
user |
---|
|
* Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.
Методы
Метод | Описание |
---|---|
user.fields | Получение списка названий полей пользователя. |
user.current | Получение информации о текущем пользователе. |
user.add | Приглашает пользователя. |
user.update | Обновляет данные пользователя. |
user.get | Получение фильтрованного списка пользователей. |
user.search | Получение списка пользователей с ускоренным поиском по персональным данным. |