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

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

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

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

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

Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrix24

подсказка

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


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

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

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

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

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

    Результат = OPI_Bitrix24.НайтиПользователей(URL, СтруктураФильтра, Токен);
    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint bitrix24 НайтиПользователей \
      --url "b24-ar17wx.bitrix24.by" \
      --filter "{'UF_DEPARTMENT_NAME':'Битрикс'}" \
      --token "***"
Результат
{
 "result": [
  {
   "ID": "1",
   "XML_ID": "53818298",
   "ACTIVE": true,
   "NAME": "Антон",
   "LAST_NAME": "Титовец",
   "EMAIL": "no-reply@bitrix24.com",
   "LAST_LOGIN": "2026-05-17T18:55:11+00:00",
   "DATE_REGISTER": "2024-02-10T00:00:00+00:00",
   "TIME_ZONE": "Europe/Minsk",
   "IS_ONLINE": "N",
   "TIMESTAMP_X": {},
   "LAST_ACTIVITY_DATE": {},
   "PERSONAL_GENDER": "",
   "PERSONAL_BIRTHDAY": "",
   "PERSONAL_PHOTO": "https://cdn-ru.bitrix24.by/b28528874/main/d7e/d7e99cf556e4ab676463dae2c00ddfbb/a7e0af6899300e3c684ca...",
   "UF_EMPLOYMENT_DATE": "",
   "UF_DEPARTMENT": [
    1,
    638
   ],
   "USER_TYPE": "employee"
  },
  {
   "ID": "10",
   "XML_ID": "56016490",
   "ACTIVE": true,
   "NAME": "Techno",
   "LAST_NAME": "Pizza",
   "EMAIL": "iscript13@gmail.com",
   "LAST_LOGIN": "2024-07-13T14:46:11+00:00",
   "DATE_REGISTER": "2024-06-15T00:00:00+00:00",
   "IS_ONLINE": "N",
   "TIMESTAMP_X": {},
   "LAST_ACTIVITY_DATE": {},
   "PERSONAL_GENDER": "",
   "PERSONAL_BIRTHDAY": "",
   "UF_EMPLOYMENT_DATE": "",
   "UF_DEPARTMENT": [
    1,
    640
   ],
   "USER_TYPE": "employee"
  },
  {
   "ID": "12",
   "XML_ID": "56479740",
   "ACTIVE": true,
   "NAME": "Bay",
   "LAST_NAME": "Selonarrend",
   "EMAIL": "oarismos@gmail.com",
   "LAST_LOGIN": "2024-07-13T07:17:17+00:00",
   "DATE_REGISTER": "2024-07-13T00:00:00+00: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": false,
   "EMAIL": "hey@exepmple.com",
   "LAST_LOGIN": "",
   "DATE_REGISTER": "2024-07-28T00:00:00+00: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-28T00:00:00+00: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-28T00:00:00+00: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-28T00:00:00+00: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-28T00:00:00+00:00",
   "IS_ONLINE": "N",
   "TIMESTAMP_X": {},
   "PERSONAL_GENDER": "",
   "PERSONAL_BIRTHDAY": "",
   "UF_EMPLOYMENT_DATE": "",
   "UF_DEPARTMENT": [
    1
   ],
   "USER_TYPE": "employee"
...