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

Версия от 13:40, 2 декабря 2010

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

<?xml version="1.0" encoding="UTF-8"?>
<request method="user.getList">
  <account></account>
  <sid></sid>
  <status></status>
  <userGroup>
    <id></id>
  </userGroup>
  <sortType></sortType>
  <pageCurrent></pageCurrent>
  <pageSize></pageSize>
  <signature></signature>
</request>

Название	Тип	Значение	Примечание
status	enum	статус пользователя	список допустимых значений смотри в разделе статусы пользователей. Игнорируется если задана группа
userGroup.id	int	идентификатор группы (фильтр по группе)
sortType	enum	тип сортировки	список допустимых значений смотри в разделе типы сортировок пользователей
pageCurrent	int	текущая страница
pageSize	int	размер получаемого списка	не больше 100
signature	string(32)	подпись

Ответ:

<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>

Перейти

@@ Строка 18: / Строка 18: @@
 !width="150"|Название !!width="200"| Тип !!width="50%"| Значение !! Примечание
 |-
-|status ||enum ||статус пользователя || список допустимых значений смотри в разделе [[ПланФикс API:Статусы пользователей|статусы пользователей]]
+|status ||enum ||статус пользователя || список допустимых значений смотри в разделе [[ПланФикс API:Статусы пользователей|статусы пользователей]]. Игнорируется если задана группа
 |-
 |userGroup.id ||int ||идентификатор группы (фильтр по группе) ||