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