Пример get_task запроса
https://your-domain.com/api/admin/v2/?action=get_task&
page=/project/PROJECT_ID/TASK_ID/SUBTASK_ID/&hash=HASH
Возвращает данные выбранной открытой или закрытой задачи/подзадачи определенного проекта
Обязательные параметры:
Необязательные параметры:
- extra — возвращает дополнительные данные по задаче/подзадаче (можно указывать через запятую, например extra=text,subscribers,files):
text или html — описание в текстовом или html формате соответственно
subscribers — список подписчиков
files — информация о прикрепленных в описание файлах
Возвращаемые данные по задаче/подзадаче:
- id — её уникальный номер
- name — название задачи/подзадачи
- status — статус (active/done — открытая/закрытая)
- priority — приоритет (диапазон значений: 0..10)
- user_from и user_to — информация об авторе и ответственном сотруднике
- project — информация о проекте (его id, name и page)
- parent — массив данных о родительской задаче (если в параметре page указана страница подзадачи)
- text — текст описания задачи/подзадачи в текстовом или html формате (если в запросе указан соответствующий параметр extra)
- date_added — дата и время создания
- date_start — дата, когда задача/подзадача должна стартовать (если указано)
- date_end — дата, когда задача/подзадача должна быть закрыта (если указано)
- date_closed — дата и время закрытия
- time_end — время завершения задачи/подзадачи (если указано)
- max_time и max_money — плановые временные и финансовые затраты (если указаны)
- tags — массив в формате id: name для статусов и меток задачи/подзадачи (если указаны)
- files — информация о прикрепленных в описание файлах (если в запросе указан соответствующий параметр extra):
id — уникальный номер файла (можно использовать в методе
download для скачивания по API)
size — размер файла (в байтах)
name — название файла с расширением
page — часть ссылки для скачивания напрямую (для полного пути перед полученным значением укажите адрес вашего аккаунта, например https://your-domain.worksection.com/download/123456)
- subscribers — список подписчиков с информацией по ним (если в запросе указан соответствующий параметр extra)
Пример JSON ответа
Показан для подзадачи/под-подзадачи (для задачи структура ответа идентична, только без массива данных parent)
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:
{
"status": "ok",
"data": {
"id": "SUBTASK_ID",
"name": "SUBTASK_NAME",
"page": "/project/PROJECT_ID/TASK_ID/SUBTASK_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/"
},
"parent": {
"id": "TASK_ID",
"name": "TASK_NAME",
"page": "/project/PROJECT_ID/TASK_ID/",
"status": "active",
"priority": "0..10",
},
"text": "SUBTASK_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"
}
]
}
}