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

user.current

Scope: user Права на выполнение: для всех

Перечень полей пользователей Битрикс24, который будет получен в результате выполнения метода, зависит от скоупа приложения/вебхука. Подробности о доступе к данным пользователей можно узнать в статье.

Получение информации о текущем Тот чей токен вы использовали при вызове рест. Если вы используете сохраненный админский токен - то выведется администратор, если используете токен, который приходит в POST-запросе во фрейм приложения, то будет пользователь, который зашел в приложение пользователе.

Параметры

Метод параметров не имеет. Однако, сделав rest запрос с использованием данных из $_REQUEST к домену DOMAIN и добавив AUTH_ID к запросу для доступа к Битрикс24, можно узнать какой пользователь открыл страницу в контексте Битрикс24.

Вызов

BX24.callMethod('user.current', {}, function(res){
	alert('Привет, ' + res.data().NAME + '!');
});

Запрос (xml для наглядности ответа)

https://my.bitrix24.ru/rest/user.current.xml?auth=7c9d8f00ea0ddd9e02cab3eb2b3bd0d1

Ответ

<response>
	<result>
		<ID>1</ID>
		<ACTIVE>1</ACTIVE>
		<EMAIL>sigurd@example.com</EMAIL>
		<NAME>Одмин</NAME>
		<LAST_NAME>
		<SECOND_NAME>
		<PERSONAL_GENDER>
		<PERSONAL_PROFESSION>
		<PERSONAL_WWW>
		<PERSONAL_BIRTHDAY>1955-04-10T00:00:00+03:00</PERSONAL_BIRTHDAY>
		<PERSONAL_PHOTO>/upload/main/80c/44169_C5_PrimalWaterE500CC.jpg</PERSONAL_PHOTO>
		<PERSONAL_ICQ>
		<PERSONAL_PHONE>
		<PERSONAL_FAX>
		<PERSONAL_MOBILE>
		<PERSONAL_PAGER>
		<PERSONAL_STREET>
		<PERSONAL_CITY>
		<PERSONAL_STATE>
		<PERSONAL_ZIP>
		<PERSONAL_COUNTRY>0</PERSONAL_COUNTRY>
		<WORK_COMPANY>
		<WORK_POSITION>
		<UF_DEPARTMENT>128</UF_DEPARTMENT>
		<UF_INTERESTS>
		<UF_SKILLS>
		<UF_WEB_SITES>
		<UF_XING>
		<UF_LINKEDIN>
		<UF_FACEBOOK>
		<UF_TWITTER>
		<UF_SKYPE>
		<UF_DISTRICT>
		<UF_PHONE_INNER>
	</result>
</response>


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

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

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

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

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Максим Месилов
Этот метод очень удобно использовать для приложений 2 типа, которые исполняются у вас на сервере.

Задача: при загрузке приложения узнать пользователя и в зависимости от этого формировать интерфейс приложения.

При загрузке вашего приложения приходит $_REQUEST следующего вида:
Код
["DOMAIN"]=> string(25) "bitrixinsider.bitrix24.ru"  // домен, работающий с приложением
["PROTOCOL"]=> string(1) "1"  // https 
["LANG"]=> string(2) "ru"  // локаль 
["APP_SID"]=> string(32) "705f…"  // Служебный параметр, служащий для подписи сообщений между фреймом с приложением и его окружением. Используется Bitrix24 
["AUTH_ID"]=> string(32) "956d…" 
["AUTH_EXPIRES"]=> string(4) "3600" 
["REFRESH_ID"]=> string(32) "95c2…"  
["member_id"]=> string(32) "62b8fe…" // уникальный идентификатор портала, не зависящий от его домена. Т.к. домен портала может быть изменён
AUTH_ID и DOMAIN достаточно для выполнения запроса user.current и понимания того, кто пытается загрузить ваше приложение
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх