ПланФикс API userGroup.getList

Материал из ПланФикс
Версия от 14:49, 23 августа 2010; Seva (обсуждение | вклад) (Новая страница: «Получение полного списка групп пользователей на аккаунте. Не требует админ прав. Формат з...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Получение полного списка групп пользователей на аккаунте. Не требует админ прав. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="userGroup.update">
  <account></account>
  <sid></sid>
  <signature></signature>
</request>
Название Тип Значение Примечание
account string имя аккаунта, на котором выполняется функция
sid string(32) ключ сессии
signature string(32) подпись

Отвте:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <userGroups count="count" totalCount="totalCount">
    <userGroup>
      <id></id>
      <name></name>
      <userCount></userCount>
    </userGroup>
    <userGroup>
      <id></id>
      <name></name>
      <userCount></userCount>
    </userGroup>
    <!-- ... -->
  </userGroups>
</response>
Название Тип Значение Примечание
userGroups корневой элемент, содержащий список групп
userGroups count int количество групп возвращенных запросом
userGroups totalCount int количество групп удовлетворяющих запросу
userGroup элемент группы
userGroup.id int идентификатор группы
userGroup.name string название группы
userGroup.userCount int количество пользоавателей в группе

Для пользователей не с админ правами, значение поля userCount - будет всегда рано 0.


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

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>
Значение code Расшифровка
0000 неизвестная ошибка


Перейти