Planfix API: projectGroup.getList: Difference between revisions

From Planfix
Jump to: navigation, search
No edit summary
 
Line 69: Line 69:
== Go To ==
== Go To ==
*[[Planfix API:Project groups|Project groups]]
*[[Planfix API:Project groups|Project groups]]
*[[Error codes]]
*[[Error codes XML API v1|Error codes]]
*[[List of functions]]
*[[List of functions]]

Latest revision as of 09:37, 6 March 2024

Function for getting a list of project groups Request format:

<?xml version="1.0" encoding="UTF-8"?>
<request method="projectGroup.getList">
  <account></account>
  <sid></sid>
  <signature></signature>
</request>
Name Type Value Notes
signature string(32) signature

Response:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <projectGroups totalCount="totalCount">
    <projectGroup>
      <id></id>
      <name></name>
    </projectGroup>
    <!-- ... -->
  </projectGroups>
</response>
Name Type Value Notes
projectGroups root element, contains a list of project groups
projectGroups totalCount int number of project groups
projectGroup root element that describes a project group in the list
id int project group identifier
name string project group name


An empty response will not generate an error. If there are no project groups in the resulting selection, the response will look as follows:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <projectGroups totalCount="0"></projectGroups>
</response>

Otherwise, an error response will be returned:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Go To