Planfix API task.getMulti

From Planfix
Jump to: navigation, search

A function for retrieving multiple task cards. This function lets you get data for up to 100 tasks per request. Request format:

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.getMulti">
  <account></account>
  <sid></sid>
  <tasks>
    <id></id>
    <id></id>
    <general></general>
    <general></general>
    <!-- ... -->
  </tasks>
  <signature></signature>
</request>
Name Type Value Notes
tasks.id int IDs of the tasks you would like to receive information about
tasks.general int the numbers of the tasks you would like to receive information about
signature string(32) request signature


When the function executes successfully, the response will look as follows:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <tasks count="count">
    <task>
      <id></id>
      <!-- ... -->
    </task>
    <!-- ... -->
  </tasks>
</response>
Name Type Value Notes
tasks root element, contains a list of tasks
tasks count int number of tasks returned as a result of executing the function
task task see the section on the response to retrieving a task card 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