Отримання окремої задачі через API: get_task


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

?action=get_task&id_task=TASK_ID

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


Обов'язкові параметри:
  • id_task — ID завдання
Необов'язкові параметри:
  • extra — додаткові дані по завданнях, можливі значення (можна вказувати через кому, наприклад extra=text,files):
  • text або html — опис у текстовому або html форматі
    files — інформація по файлах, прикріплених до опису завдання
    comments — п'ять останніх коментарів
    relations — інформація по зв'язках з іншими завданнями
    subtasks — інформація по підзавданнях (у масиві child)
    subscribers — список підписників
  • filter=active — тільки дані по відкритих завданнях (при використанні параметру extra=subscribers)
    Фільтр тільки по закритих не передбачено

Повертаються наступні дані:
  • id — ID завдання
  • name — назва завдання
  • page — посилання на завдання
  • status — стан (active/done — відкрита/закрита)
  • priority — пріоритет (діапазон значень: 0..10)
  • user_from і user_to — автор і відповідальний по завданню
  • project — інформація про проєкт
  • parent — батьківська задача (якщо в запиті вказано ID підзавдання)
  • 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)
  • subscribers — список підписників (якщо в запиті вказано параметр extra=subscribers)
  • relations — інформація по зв'язках з іншими завданнями (якщо в запиті вказано параметр extra=relations):
  • from — вхідні зв'язки:
    type — тип зв'язку finish-to-start/start-to-start
    task — інформація по зв'язаному завданню
    to — вихідні зв'язки (аналогічно from)
  • child — інформація по підзавданням (якщо в запиті вказано ID задачі та параметр extra=subtasks)

Приклад JSON відповіді
При успішному виконанні запиту, відповідь буде містити статус ok і наступні дані:

*для задачі

{
    "status": "ok",
    "data": {
        "id": "TASK_ID",
        "name": "TASK_NAME",
        "page": "/project/PROJECT_ID/TASK_ID/",
        "status": "active",
        "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": "25",
        "max_money": "50",
        "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"   }  ],   "subscribers": [   {   "id": "USER_ID",  "email": "USER_EMAIL",   "name": "USER_NAME_1"
  },   {   "id": "USER_ID",  "email": "USER_EMAIL",   "name": "USER_NAME_2"   }   ], "relations": {
"to": [ { "type": "finish-to-start", "task": { "id": "TASK_ID", "name": "TASK_NAME",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "active", "priority": "0..10" } } ], "from": [ { "type": "start-to-start", "task": { "id": "TASK_ID",
"name": "TASK_NAME",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "done", "priority": "0..10" } } ] }, "child": [ { "id": "SUBTASK_ID", "name": "SUBTASK_NAME_1", "page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/", "status": "active", "priority": "0..10", "child": [ { "id": "SUBTASK_ID", "name": "SUBTASK_NAME_2", "page": "/project/PROJECT_ID/TASK_ID/SUBTASK_ID/", "status": "done", "priority": "0..10" } ] } ] } }
*для підзадачі/під-підзадачі (ідентична структура відповіді, тільки з додатковим масивом даних parent та без масиву child)

{
    "status": "ok",
    "data": {
        "id": "SUB-SUBTASK_ID",
        "name": "SUB-SUBTASK_NAME",
        "page": "/project/PROJECT_ID/TASK_ID/SUB-SUBTASK_ID/", 
        ... ... ...,
        "project": 
            ... ... ...
        ,
        "parent": {
            "id": "SUBTASK_ID",
            "name": "SUBTASK_NAME",
            "page": "/project/PROJECT_ID/SUBTASK_ID/",
            "status": "active",
            "priority": "0..10",
            "parent": {
                "id": "TASK_ID",
                "name": "TASK_NAME",
                "page": "/project/PROJECT_ID/TASK_ID/",
                "status": "active",
                "priority": "0..10",
            }
        },
        "text": ...,
        ... ... ...
        "relations": 
            ... ... ...
        
    }
}