Planfix API contact.getGroupList: Difference between revisions
From Planfix
No edit summary |
(→Go To) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 13: | Line 13: | ||
|account|| string || the account on which the request is made с || | |account|| string || the account on which the request is made с || | ||
|- | |- | ||
|sid || string(32) ||session key || issued as a result of | |sid || string(32) ||session key || issued as a result of [[Planfix API: Authentication|authentication]] | ||
|- | |- | ||
|signature|| string(32) || packet signature || | |signature|| string(32) || packet signature || | ||
Line 41: | Line 41: | ||
|'''contactGroups''' ||int ||list of groups || | |'''contactGroups''' ||int ||list of groups || | ||
|- | |- | ||
|'''contactGroups''' count ||int || number of groups in the list || | |'''contactGroups''' count ||int || number of groups in the list || | ||
|- | |- | ||
|'''contactGroups''' totalCount ||int ||total number of groups in the list || | |'''contactGroups''' totalCount ||int ||total number of groups in the list || | ||
Line 64: | Line 64: | ||
== Go To == | == Go To == | ||
*[[Planfix API:Contacts]] | *[[Planfix API:Contacts]] | ||
*[[Error codes]] | *[[Error codes XML API v1|Error codes]] | ||
*[[List of functions]] | *[[List of functions]] |
Latest revision as of 09:24, 6 March 2024
The request to get the list of contact groups looks like this:
<?xml version="1.0" encoding="UTF-8"?>
<request method="contact.getGroupList">
<account></account>
<sid></sid>
<signature></signature>
</request>
Name | Type | Value | Note |
---|---|---|---|
account | string | the account on which the request is made с | |
sid | string(32) | session key | issued as a result of authentication |
signature | string(32) | packet signature |
Response when the request is successfully executed:
<?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>
Name | Type | Value | Note |
---|---|---|---|
contactGroups | int | list of groups | |
contactGroups count | int | number of groups in the list | |
contactGroups totalCount | int | total number of groups in the list | |
group | group | ||
group.id | int | group identifier | |
group.name | string | group name |
Otherwise, a response with an error will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
<code></code>
</response>