Отримання списку всіх задач/підзадач аккаунту через 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/",
... ... ...
}
]
}
Ця стаття була вам корисною?
Так, дякую!
Ні