ПланФикс API user.getList: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) Нет описания правки |
Seva (обсуждение | вклад) Нет описания правки |
||
| Строка 6: | Строка 6: | ||
<sid></sid> | <sid></sid> | ||
<status></status> | <status></status> | ||
<onlyOnline></onlyOnline> | |||
<userGroup> | <userGroup> | ||
<id></id> | <id></id> | ||
| Строка 19: | Строка 20: | ||
|- | |- | ||
|status ||enum ||статус пользователя || список допустимых значений смотри в разделе [[ПланФикс API:Статусы пользователей|статусы пользователей]]. Игнорируется если задана группа | |status ||enum ||статус пользователя || список допустимых значений смотри в разделе [[ПланФикс API:Статусы пользователей|статусы пользователей]]. Игнорируется если задана группа | ||
|- | |||
|onlyOnline ||bool||показывать только сотрудников online || | |||
|- | |- | ||
|userGroup.id ||int ||идентификатор группы (фильтр по группе) || | |userGroup.id ||int ||идентификатор группы (фильтр по группе) || | ||
Версия от 14:55, 2 декабря 2010
Функция получения списка пользователей. Формат запроса:
<?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>
<signature></signature>
</request>| Название | Тип | Значение | Примечание |
|---|---|---|---|
| status | enum | статус пользователя | список допустимых значений смотри в разделе статусы пользователей. Игнорируется если задана группа |
| onlyOnline | bool | показывать только сотрудников online | |
| 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>