ПланФикс API user.getList: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
Строка 13: Строка 13:
   <pageCurrent></pageCurrent>
   <pageCurrent></pageCurrent>
   <pageSize></pageSize>
   <pageSize></pageSize>
   <signature></signature>
   <filters>
    <filter>
      <type></type>
      <operator></operator>
      <value></value>
    </filter>
    ...
  </filters>
</request>
</request>
</source>
</source>
Строка 31: Строка 38:
|pageSize ||int ||размер получаемого списка || не больше 100
|pageSize ||int ||размер получаемого списка || не больше 100
|-
|-
|signature ||string(32) ||подпись ||
|filters || || дополнительные фильтры || перечень и формат допустимых значений смотри в разделе [[ПланФикс API:Фильтры сотрудников|фильтры сотрудников]]
|-
|-
|}
|}

Текущая версия от 11:28, 9 сентября 2021

Функция получения списка пользователей. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="user.getList">
  <account></account>
  <sid></sid>
  <status></status>
  <onlyOnline></onlyOnline>
  <userGroup>
    <id></id>
  </userGroup>
  <sortType></sortType>
  <pageCurrent></pageCurrent>
  <pageSize></pageSize>
  <filters>
    <filter>
      <type></type>
      <operator></operator>
      <value></value>
    </filter>
    ...
  </filters>
</request>
Название Тип Значение Примечание
status enum статус пользователя список допустимых значений смотри в разделе статусы пользователей. Игнорируется если задана группа
onlyOnline bool показывать только сотрудников online
userGroup.id int идентификатор группы (фильтр по группе)
sortType enum тип сортировки список допустимых значений смотри в разделе типы сортировок пользователей
pageCurrent int текущая страница 0 - используется для получения количества сотрудников
pageSize int размер получаемого списка не больше 100
filters дополнительные фильтры перечень и формат допустимых значений смотри в разделе фильтры сотрудников


Ответ:

<response status="ok">
  <users count="count" totalCount="totalCount">
    <user>
      <!-- ... -->
    </user>
    <user>
      <!-- ... -->
    </user>
    <!-- ... -->
  </users>
</response>
Название Тип Значение Примечание
users список пользователей
users count int количество пользователей в списке
users totalCount int количество пользователей удовлетворяющих условию запроса
users.user описание пользователя, смотри полное описание структуры в разделе user.get


В противном случае будет возвращен ответ с ошибкой:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Перейти