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