Перейти к основному содержимому

Найти пользователей

Получает список пользователей по заданному фильтру

Функция НайтиПользователей(Знач URL, Знач СтруктураФильтра, Знач Токен = "") Экспорт

ПараметрCLI опцияТипОбяз.Назначение
URL--urlСтрокаURL внешнего вебхука или адрес Bitrix24 при использовании токена
СтруктураФильтра--filterСтруктура Из КлючИЗначениеФильтр. См. ПолучитьСтруктуруФильтраПользователей
Токен--tokenСтрокаТокен авторизации, если используется не вебхук

Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrxi24


подсказка

Метод в документации API: user.update


Пример использования для 1С:Предприятие/OneScript
    URL = "https://b24-ar17wx.bitrix24.by/rest/1/yg2...";

СтруктураФильтра = Новый Структура;
СтруктураФильтра.Вставить("NAME" , "Виталий");
СтруктураФильтра.Вставить("LAST_NAME" , "Альпака");
СтруктураФильтра.Вставить("WORK_POSITION" , "DevOps инженер");
СтруктураФильтра.Вставить("UF_DEPARTMENT_NAME", "Отдел маркетинга");
СтруктураФильтра.Вставить("USER_TYPE" , "employee");

Результат = OPI_Bitrix24.НайтиПользователей(URL, СтруктураФильтра);

URL = "b24-ar17wx.bitrix24.by";
Токен = "2f4e4067006e9f06006b12e400000001000...";

СтруктураФильтра = Новый Структура;
СтруктураФильтра.Вставить("UF_DEPARTMENT_NAME", "Битрикс");

Результат = OPI_Bitrix24.НайтиПользователей(URL, СтруктураФильтра, Токен);
    # JSON данные также могут быть переданы как путь к файлу .json

oint bitrix24 НайтиПользователей \
--url "b24-ar17wx.bitrix24.by" \
--filter "{'UF_DEPARTMENT_NAME':'Битрикс'}" \
--token "***"
Результат
{
"result": [
{
"ID": "12",
"XML_ID": "56479740",
"ACTIVE": true,
"NAME": "Bay",
"LAST_NAME": "Selonarrend",
"EMAIL": "oarismos@gmail.com",
"LAST_LOGIN": "2024-07-13T10:17:17+03:00",
"DATE_REGISTER": "2024-07-13T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"LAST_ACTIVITY_DATE": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "18",
"XML_ID": "56701916",
"ACTIVE": true,
"EMAIL": "hey@exepmple.com",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-28T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "34",
"XML_ID": "56702240",
"ACTIVE": false,
"EMAIL": "537fafa9-e5ea-4221-bd46-4f6db2609634@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-28T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "38",
"XML_ID": "56702244",
"ACTIVE": false,
"EMAIL": "442145e1-75e4-4c85-ac6d-e4da44c859a8@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-28T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "42",
"XML_ID": "56702314",
"ACTIVE": true,
"EMAIL": "3f70caee-2203-46ec-b53c-24f1c7092056@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-28T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "46",
"XML_ID": "56702336",
"ACTIVE": false,
"EMAIL": "f23e7d22-016d-4711-aa0f-439951951f35@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-28T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "50",
"XML_ID": "56702654",
"ACTIVE": false,
"EMAIL": "360bd8ae-146c-497b-ae87-0699855f21b7@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-28T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "54",
"XML_ID": "56721830",
"ACTIVE": false,
"EMAIL": "15ea8982-762a-44a0-9c53-c97530015c46@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-29T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
"PERSONAL_GENDER": "",
"PERSONAL_BIRTHDAY": "",
"UF_EMPLOYMENT_DATE": "",
"UF_DEPARTMENT": [
1
],
"USER_TYPE": "employee"
},
{
"ID": "58",
"XML_ID": "56731228",
"ACTIVE": false,
"EMAIL": "60de8e25-7175-44a5-9cdb-cd1fd6ac1e3b@exepmple.org",
"LAST_LOGIN": "",
"DATE_REGISTER": "2024-07-30T03:00:00+03:00",
"IS_ONLINE": "N",
"TIMESTAMP_X": {},
...