Planfix API contact.getGroupList: Difference between revisions
From Planfix
No edit summary |
No edit summary |
||
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 || |
Revision as of 09:17, 4 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>