WORKSECTION

Файлы

Как добавлять файлы к проектам, задачам и комментариям через 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);
Эта статья была вам полезна? Да, спасибо! Нет

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

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

https://youraccount.worksection.com/api/admin/v2/?action=download&
id_file=FILE_ID&hash=HASH
Скачивает выбранный файл
*прикрепленный в описании проекта, описании задания, комментарии или напрямую в разделе Файлы

Обязательные параметры:
  • id_file — ID файла (можно получить через метод get_files)
Эта статья была вам полезна? Да, спасибо! Нет

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

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

https://youraccount.worksection.com/api/admin/v2/?action=get_files&
id_project=PROJECT_ID&hash=HASH
Возвращает список файлов указанного проекта или задания
*файлы проекта – из описания проекта и добавленные непосредственно в раздел Файлы
*файлы задания – из описания задания и из комментариев

Обязательные параметры:
  • 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",
            ... ... ...
        }
    ]
}
Эта статья была вам полезна? Да, спасибо! Нет
Вторжение России в Украину Worksection прекратил работу на территории РФ Почему?
esc
или
Распечатать