СправкаСодержание
Файлы
Методы
Метод загружает файлы для последующего прикладывания их в задачи. Файлы, на которые не ссылается ни одна задача, через некоторое время удаляются.
POST https://api.pyrus.com/v4/files/upload
Authorization: Bearer gAAA***** Content-type: multipart/form-data; boundary=8d2f42366b41441 Content-Length: 5222
--8d2f42366b41441 Content-Disposition: form-data; name="file"; filename="filename.jpg" Content-Type: application/octet-stream //тело файла --8d2f42366b41441--
{
"guid": "08923d83-255b-4f18-b0eb-5c4d3b9bf1d2",
"md5_hash": "cd4df826e3b9ce6e7895d8a31536d99d"
}
curl
curl -X POST \
https://api.pyrus.com/v4/files/upload \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
-H 'Content-Type: multipart/form-data' \
-H 'content-type: multipart/form-data; boundary=----8d2f42366b41441' \
-F 'filename.jpg=@C:\Path\To\File\filename.jpg'
В ответ вы получите идентификатор загруженного файла и хеш файла, вычисленный по алгоритму MD5. Чтобы приложить загруженный файл в задачу, воспользуйтесь методом добавления комментария и передайте полученный идентификатор в поле attachments.
Для загрузки файла необходимо выставлять заголовку Content-Type значение multipart/form-data; boundary=8d2f42366b41441, где boundary — это уникальный идентификатор, которым будет начинаться и заканчиваться тело файла в запросе.
Content-Length — размер содержимого запроса. Вычисляется для всего тела, включая идентификатор boundary.
Загружайте ровно один файл, используя указанный запрос. Если необходимо загрузить несколько файлов, запустите запрос несколько раз соответственно. Максимальный размер прикладываемого файла — 250 Mb.
Метод скачивает файл из pyrus.
GET https://api.pyrus.com/v4/files/download/1334
Content-Disposition: attachment; filename=test.txt Content-Length: 12 Content-Type: application/octet-stream
file content
curl
curl -X GET \
https://api.pyrus.com/v4/files/download/1334 \
-H 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
-H 'Content-Type: application/json'