Питання і відповіді - що таке Отримання списку всіх задач аккаунту через API: get_all_tasks? Допомога користувачам інформаційної системи управління бізнес процесами

Приклад get_all_tasks запиту

?action=get_all_tasks

Повертає відкриті та закриті завдання по всіх проєктах
*окрім завдань з відкладеною публікацією
*для отримання підзавдань додайте параметр extra=subtasks

Необов'язкові параметри:

extra — додаткові дані по завданнях, можливі значення (можна вказувати через кому, наприклад extra=text,files):

text або html — опис у текстовому або html форматі

files — інформація по файлах, прикріплених до опису завдання

comments — п'ять останніх коментарів

relations — інформація по зв'язках з іншими завданнями

subtasks — інформація по підзавданнях (у масиві child)

archive — завдання архівних проєктів

filter=active — тільки дані по відкритих завданнях (фільтр тільки по закритих не передбачено)

Повертаються наступні дані:

id — ID завдання
name — назва завдання
page — посилання на завдання
status — стан (active/done — відкрита/закрита)
priority — пріоритет (діапазон значень: 0..10)
user_from і user_to — автор і відповідальний по завданню
project — інформація про проєкт
text — опис завдання в текстовому або html форматі (якщо в запиті вказано відповідний параметр extra)
date_added — дата та час створення
date_start — дата старту (якщо зазначено)
date_end — дата завершення (якщо зазначено)
date_closed — дата та час закриття
time_end — час завершення (якщо зазначено)
max_time і max_money — планові часові та фінансові витрати (якщо вказано)
tags — теги завдання у форматі id: name (якщо вказано)
files — інформація по прикріплених файлах (якщо в запиті вказано параметр extra=files):

id — ID файлу (можна використовувати в методі download для завантаження через API)

size — розмір файлу (в байтах)

name — назва файлу з розширенням

page — частина посилання для завантаження напряму (для повного шляху перед отриманим значенням вкажіть адресу вашого акаунту, наприклад https://youraccount.worksection.com/download/123456)

relations — інформація по зв'язках з іншими завданнями (якщо в запиті вказано параметр extra=relations):

from — вхідні зв'язки:

type — тип зв'язку finish-to-start/start-to-start

task — інформація по зв'язаному завданню

to — вихідні зв'язки (аналогічно from)

child — інформація по підзавданням (якщо в запиті вказано параметр extra=subtasks)

Приклад JSON відповіді

При успішному виконанні запиту, відповідь буде містити статус 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"
                }
            ],
            "relations": {
                "to": [
                    {
                        "type": "finish-to-start",
                        "task": {
                            "id": "SUBTASK_ID",
                            "name": "SUBTASK_NAME",
                            "page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/",
                            "status": "active",
                            "priority": "0..10"
                        }
                    }
                ],
                "from": [
                    {
                        "type": "start-to-start",
                        "task": {
                            "id": "SUBTASK_ID",
                            "name": "SUBTASK_NAME",
                            "page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/",
                            "status": "done",
                            "priority": "0..10"
                        }
                    }
                ]
            },
            "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/",
            ... ... ...
        }
    ]
}