ПланФикс 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>