Planfix API action.getList

From Planfix
Revision as of 09:25, 6 August 2023 by Aliona (talk | contribs)
Jump to: navigation, search

Getting a list of actions in a task:

<?xml version="1.0" encoding="UTF-8"?>
<request method="action.getList">
  <account></account>
  <sid></sid>
  <task>
    <id></id>
    <general></general>
  </task>
  <contact>
    <general></general>
  </contact>
  <pageCurrent></pageCurrent>
  <pageSize></pageSize>
  <sort></sort>
  <signature></signature>
</request>
Name Type Value Notes
task (contact) task/contact from which the action is being retrieved - only one node (either a task or a contact)
task.id int task identifier
task.general int task number (if given, used instead of ID)
contact.general int contact's phone number
pageCurrent int current page
pageSize int size of the requested page cannot exceed 100
sort enum: {asc,desc} list sorting not required; default is desc
signature string(32) signature


Response:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <actions count="count" totalCount="totalCount">
    <action><!-- ... --></action>
    <action><!-- ... --></action>
    <!-- ... -->
  </actions>
</response>
Name Type Value Notes
actions root node containing a list of actions
actions count int number of actions in the response
actions totalCount int number of actions satisfying the request
action action. see the action.get / Get action section for a description of this parameter


Otherwise, an error response will be returned:

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


Go To