ПланФикс API task.getMulti: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
(Новая страница: «Функция получения множества карточек задачи. Формат запроса: <source lang="xml"> <?xml version="1.0" encoding="UT...»)
 
Нет описания правки
Строка 2: Строка 2:
<source lang="xml">
<source lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<request method="task.get">
<request method="task.getMulti">
   <account></account>
   <account></account>
   <sid></sid>
   <sid></sid>

Версия от 07:16, 12 октября 2013

Функция получения множества карточек задачи. Формат запроса:

<?xml version="1.0" encoding="UTF-8"?>
<request method="task.getMulti">
  <account></account>
  <sid></sid>
  <tasks>
    <id></id>
    <id></id>
    <!-- ... -->
  </tasks>
  <signature></signature>
</request>
Название Тип Значение Примечание
tasks.id int идентификаторы задач, информацию о которых хотим получить
signature string(32) подпись запроса

В случае удачного выполнения функции будет получен ответ следующего вида:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <tasks count="count">
    <task>
      <id></id>
      <!-- ... -->
    </task>
    <!-- ... -->
  </tasks>
</response>
Название Тип Значение Примечание
tasks корневой элемент, содержит список задач
tasks count int количество задач возвращенных в результате выполнения функции
task задача описание данного параметра смотрите в секции ответ на получении карточки задачи


В противном случае будет возвращен ответ с ошибкой:

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

Перейти