WORKSECTION

Файлы

Получение списка файлов через API: get_files

Пример get_files запроса

?action=get_files&id_project=PROJECT_ID
Возвращает список файлов указанного проекта или задания
*файлы проекта – из описания проекта и добавленные непосредственно в раздел Файлы
*файлы задания – из описания задания и из комментариев

Обязательные параметры:
  • id_project — ID проекта (становится необязательным при указании ID задания)
Необязательные параметры:
  • id_task — ID задания

Возвращаемые данные:
  • id — ID файла
  • page — часть ссылки для скачивания напрямую (для полного пути перед полученным значением укажите адрес вашего аккаунта, например https://youraccount.worksection.com/download/123456)
  • name — название файла с расширением
  • size — размер файла (в байтах)
  • date_added — дата и время добавления
  • user_from — кем добавлен файл

Пример JSON ответа
При успешном выполнении запроса, ответ будет содержать статус ok и следующие данные:

{
"status": "ok",
"data": [
{ "id": "FILE_ID", "page": "/download/FILE_ID",
"name": "Example.docx", "size": "FILE_SIZE",
"date_added": "YYYY—MM—DD HH:II",
"user_from": { "id": "USER_ID",
"email": "USER_EMAIL",
"name": "USER_NAME"
}
}, { "id": "FILE_ID", "page": "/download/FILE_ID", ... ... ... }
]
}
Эта статья была вам полезна? Да, спасибо! Нет

Скачивание файлов через API: download

Пример download запроса:

?action=download&id_file=FILE_ID
Скачивает выбранный файл
*прикрепленный в описании проекта, описании задания, комментарии или напрямую в разделе Файлы

Обязательные параметры:
  • id_file — ID файла (можно получить через метод get_files)

Эта статья была вам полезна? Да, спасибо! Нет

Как добавлять файлы к проектам, задачам и комментариям через API

Для добавления файлов используйте POST запросы, каждый файл в котором передается как параметр с именем attach[n], где n - любое начальное число (см. пример кода ниже).

Методы, в которых можно добавлять файлы:

Пример добавления файлов в запросе на создание задачи post_task, используя для примера PHP (curl)
 
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL,'https://youraccount.worksection.com/api/admin/
v2/?action=post_task&id_project=PROJECT_ID&title=TASK_NAME&hash=HASH');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, [
  'attach[0]' = new cURLFile('path_to_file/local_file1.pdf',
'application/pdf','nice_name1.pdf'),
  'attach[1]' = new cURLFile('path_to_file/local_file2.pdf',
'application/pdf','nice_name2.pdf'),
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);
Эта статья была вам полезна? Да, спасибо! Нет
Вторжение России в Украину Worksection прекратил работу на территории РФ Почему?
esc
или
Распечатать