ПланФикс API contact.getGroupList

Материал из Planfix
Перейти к: навигация, поиск

Запрос на получение списка групп контактов имеет следующий вид:

<?xml version="1.0" encoding="UTF-8"?>
<request method="contact.getGroupList">
    <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">
    <contactGroups count="count" totalCount="totalCount">
        <group>
            <id></id>
            <name></name>
        </group>
        <group>
            <id></id>
            <name></name>
        </group>
        <!-- ... -->
    </contactGroups >
</response>
Название Тип Значение Примечание
contactGroups int список групп
contactGroups count int количество групп в списке
contactGroups totalCount int количество групп в списке
group группа
group.id int идентификатор группы
group.name string название группы

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

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


Перейти