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