Planfix API contact.getGroupList: Difference between revisions
From Planfix
								
												
				 (Created page with "The request to get the list of contact groups looks like this: <source lang="xml"> <?xml version="1.0" encoding="UTF-8"?> <request method="contact.getGroupList">     <account></account>     <sid></sid>     <signature></signature> </request> </source> {| class="wikitable" style="margin-top: 1em; width:100% " !width="150"|Name !!width="200"| Type !!width="50%"| Value !! Note |- |account|| string ||  the account on which the request is made с ||  |- |sid || string(32) ||se...")  | 
				No edit summary  | 
				||
| Line 37: | Line 37: | ||
</source>  | </source>  | ||
{| class="wikitable" style="margin-top: 1em; width:100% "  | {| class="wikitable" style="margin-top: 1em; width:100% "  | ||
!width="150"|  | !width="150"|Name !!width="200"| Type !!width="50%"| Value !! Note  | ||
|-  | |-  | ||
|'''contactGroups''' ||int ||list of groups ||  | |'''contactGroups''' ||int ||list of groups ||  | ||
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 passing 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>