ПланФикс API task.getMulti: различия между версиями
Материал из Planfix
Seva (обсуждение | вклад) Нет описания правки |
Artem (обсуждение | вклад) Нет описания правки |
||
Строка 1: | Строка 1: | ||
Функция получения множества карточек | Функция получения множества карточек задач. Позволяет получить данные до 100 задач за запрос. Формат запроса: | ||
<source lang="xml"> | <source lang="xml"> | ||
<?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> |
Текущая версия от 08:19, 12 июля 2022
Функция получения множества карточек задач. Позволяет получить данные до 100 задач за запрос. Формат запроса:
<?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>
Название | Тип | Значение | Примечание |
---|---|---|---|
tasks.id | int | идентификаторы задач, информацию о которых хотим получить | |
tasks.general | 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>