Получение списка всех задач/подзадач аккаунта через API: get_all_tasks
Пример get_all_tasks запроса
Пример JSON ответа
https://your-domain.com/api/admin/v2/?action=get_all_tasks&hash=HASH Возвращает данные всех открытых и закрытых задач/подзадач аккаунта
В этом запросе параметр page не требуется
Необязательные параметры:
- show_subtasks=1 — возвращает поле child (если доступно), которое содержит список подзадач в аналогичном формате. Доступно 2 уровня вложенности: задача / подзадача / под-подзадача
- extra — возвращает дополнительные данные по задачам/подзадачам (можно указывать через запятую, например extra=text,files):
- filter=active (аналогично status=active) — возвращает данные только открытых задач/подзадач проекта. Для отображения только закрытых задач отдельное значение указанного параметра не предусмотрено
text или html — описание в текстовом или html формате соответственно
files — информацию о прикрепленных в описание файлах
Возвращаемые данные задач/подзадач:
- id — уникальный номер
- name — название задачи/подзадачи
- page — ссылка на задачу/подзадачу (см. формат ссылки)
- status — статус (active/done — открытая/закрытая)
- priority — приоритет (диапазон значений: 0..10)
- user_from и user_to — информация об авторе и ответственном сотруднике
- project — информация о проекте (его id, name и page)
- text — текст описания задачи/подзадачи в текстовом или html формате (если в запросе указан соответствующий параметр extra)
- date_added — дата и время создания
- date_start — дата, когда задача/подзадача должна стартовать (если указано)
- date_end — дата, когда задача/подзадача должна быть закрыта (если указано)
- date_closed — дата и время закрытия
- time_end — время завершения задачи/подзадачи (если указано)
- max_time и max_money — плановые временные и финансовые затраты (если указаны)
- tags — массив в формате id: name для статусов и меток задачи/подзадачи (если указаны)
- files — информация о прикрепленных в описание файлах (если в запросе указан соответствующий параметр extra):
- child — аналогичный массив данных по входящим в задачу подзадачам и под-подзадачам (если в запросе указан соответствующий параметр show_subtasks=1)
id — уникальный номер файла (можно использовать в методе download для скачивания по API)
size — размер файла (в байтах)
name — название файла с расширением
page — часть ссылки для скачивания напрямую (для полного пути перед полученным значением укажите адрес вашего аккаунта, например https://your-domain.worksection.com/download/123456)
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:
{
"status": "ok",
"data": [
{
"id": "TASK_ID",
"name": "TASK_NAME_1",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "done",
"priority": "0..10",
"user_from": {
"id": "USER_ID",
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"user_to": {
"id": "USER_ID",
"email": "USER_EMAIL",
"name": "USER_NAME"
},
"project": {
"id": "PROJECT_ID",
"name": "PROJECT_NAME",
"page": "/project/PROJECT_ID/"
},
"text": "TASK_TEXT",
"date_added": "YYYY-MM-DD HH:II",
"date_start": "YYYY-MM-DD",
"date_end": "YYYY-MM-DD",
"date_closed": "YYYY-MM-DD HH:II",
"time_end": "HH:II",
"max_time": "50",
"max_money": "100",
"tags": {
"TAG_ID": "TAG_NAME_1",
"TAG_ID": "TAG_NAME_2"
},
"files": [
{
"id": "FILE_ID",
"size": "FILE_SIZE",
"name": "Example.docx",
"page": "/download/FILE_ID"
}
],
"child": [
{
"id": "SUBTASK_ID",
"name": "SUBTASK_NAME_1",
"page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/",
... ... ...,
"child": [
{
"id": "SUBTASK_ID",
"name": "SUBTASK_NAME_2",
"page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/",
... ... ...
}
]
}
]
},
{
"id": "TASK_ID",
"name": "TASK_NAME_2",
"page": "/project/PROJECT_ID/TASK_ID/",
... ... ...
}
]
}
Эта статья была вам полезна?
Да, спасибо!
Нет