Документация для разработчиков
Темная тема

user.get

Описание

Получение фильтрованного списка пользователей. Метод вернет всех пользователей за исключением: ботов, пользователей для e-mail, пользователей для Открытых Линий, пользователей Реплики.

Вызов

BX24.callMethod('user.get', {"ID": 1});

Запрос

https://my.bitrix24.ru/rest/user.get.json?ID=1&auth=b961afd4148963c5d54ebeb17123d1fc

Ответ

{"result":[{"ID":"1","ACTIVE":true,"EMAIL":"sigurd@example.com","NAME":"Administrator","LAST_NAME":"","SECOND_NAME":"","PERSONAL_GENDER":"",
"PERSONAL_PROFESSION":"","PERSONAL_WWW":"","PERSONAL_BIRTHDAY":"1955-04-10T00:00:00+03:00","PERSONAL_PHOTO":"\/upload\/main\/80c\/44169_C5_PrimalWaterE500CC.jpg",
"PERSONAL_ICQ":"","PERSONAL_PHONE":"","PERSONAL_FAX":"","PERSONAL_MOBILE":"","PERSONAL_PAGER":"","PERSONAL_STREET":"","PERSONAL_CITY":"","PERSONAL_STATE":"",
"PERSONAL_ZIP":"","PERSONAL_COUNTRY":"0","WORK_COMPANY":"","WORK_POSITION":"","UF_DEPARTMENT":[128],"UF_INTERESTS":null,"UF_SKILLS":null,"UF_WEB_SITES":null,
"UF_XING":null,"UF_LINKEDIN":null,"UF_FACEBOOK":null,"UF_TWITTER":null,"UF_SKYPE":null,"UF_DISTRICT":null,"UF_PHONE_INNER":null}],"total":1}

Параметры

ПараметрОписание
sort поле, по которому сортируются результаты
order направление сортировки
  • ASC - по возрастанию.
  • DESC - по убыванию
FILTER Дополнительно можно указывать любые параметры из user.fields для фильтрации по их значениям. Кроме основных полей, доступны дополнительные:
  • UF_DEPARTMENT - принадлежность к структуре компании;
  • UF_PHONE_INNER - внутренний телефонный номер;
  • IS_ONLINE - [Y/N] - позволяет показать только авторизованных или нет пользователей.
  • NAME_SEARCH - быстрый поиск по персональным данным.
  • USER_TYPE - тип пользователя. Может принимать следующие значения:
    employee - сотрудник,
    extranet - пользователь экстранета,
    email - почтовый пользователь
  • ACTIVE - при значении true исключает из запроса уволенных пользователей.

Параметры фильтрации могут принимать значение массивов.

ADMIN_MODE Ключ для работы Получается с помощью метода user.fields в режиме администратора, служит для получения данных о любых пользователях.


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Эльзара Валишина
Сообщение непромодерировано, возможны ошибки и неточности.
'ADMIN_MODE': 'True'
0
Сергей Зеленский
Сообщение непромодерировано, возможны ошибки и неточности.
Цитата
Сергей Зеленский пишет:
Кто знает, как включить ADMIN_MODE ?
В методе user.fields ничего о нём нет. И результат выполнения user.fields тоже не содержит упоминаний об ADMIN_MODE.
Попытки указать 1, true, Y, on не увенчались успехом.  
Мод нужен для того, чтобы получить список почтовых пользователей. Если есть обходной путь - скажите обходной) Б24 облако.  
0
Сергей Зеленский
Сообщение непромодерировано, возможны ошибки и неточности.
Кто знает, как включить ADMIN_MODE ?
В методе user.fields ничего о нём нет. И результат выполнения user.fields тоже не содержит упоминаний об ADMIN_MODE.
Попытки указать 1, true, Y, on не увенчались успехом.  
0
Антон Долганин
Метод подчиняется общему правилу постранички - по умолчанию берется 50 записей.
© «Битрикс», 2001-2021, «1С-Битрикс», 2021
Наверх