Отримання списку всіх задач аккаунту через API: get_all_tasks
Приклад get_all_tasks запиту
Приклад JSON відповіді
?action=get_all_tasksПовертає відкриті та закриті завдання по всіх проєктах
*окрім завдань з відкладеною публікацією
*окрім завдань з відкладеною публікацією
*для отримання підзавдань додайте параметр extra=subtasks
Необов'язкові параметри:
- extra — додаткові дані по завданнях, можливі значення (можна вказувати через кому, наприклад extra=text,files):
- filter=active — тільки дані по відкритих завданнях (фільтр тільки по закритих не передбачено)
text або html — опис у текстовому або html форматі
files — інформація по файлах, прикріплених до опису завдання
comments — п'ять останніх коментарів
relations — інформація по зв'язках з іншими завданнями
subtasks — інформація по підзавданнях (у масиві child)
archive — завдання архівних проєктів
Повертаються наступні дані:
- 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):
- relations — інформація по зв'язках з іншими завданнями (якщо в запиті вказано параметр extra=relations):
- child — інформація по підзавданням (якщо в запиті вказано параметр extra=subtasks)
id — ID файлу (можна використовувати в методі download для завантаження через API)
size — розмір файлу (в байтах)
name — назва файлу з розширенням
page — частина посилання для завантаження напряму (для повного шляху перед отриманим значенням вкажіть адресу вашого акаунту, наприклад https://youraccount.worksection.com/download/123456)
from — вхідні зв'язки:
type — тип зв'язку finish-to-start/start-to-start
task — інформація по зв'язаному завданню
to — вихідні зв'язки (аналогічно from)
При успішному виконанні запиту, відповідь буде містити статус 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/",
... ... ...
}
]
}
Ця стаття була вам корисною?
Так, дякую!
Ні