Для разработчиков

Файлы

Команда pachca upload за один вызов выполняет оба шага загрузки файла: получает подпись методом POSTПолучение подписи, ключа и других параметров и отправляет файл в хранилище. Параметры подписи вручную копировать не нужно:

# Загрузить файлpachca upload photo.jpg # Из stdin: имя файла с расширением задаёт --namecat data.csv | pachca upload - --name data.csv

Команда возвращает key. Передайте его в поле files POSTНового сообщения вместе с отображаемым именем name. Тип file_type для картинки не нужен: изображение Пачка определяет по расширению.

# Загрузить файл и отправить в чатKEY=$(pachca upload photo.jpg -o json | jq -r '.key')pachca messages create --entity-id 123 --content "Фото" \  --files "[{\"key\":\"$KEY\",\"name\":\"photo.jpg\"}]"

Расширение в name должно совпадать с расширением файла в key. Ключ заканчивается именем загружаемого файла, а флаг --name задаёт другое имя: так данные из stdin получают имя с расширением. Если --name не указан, файл из stdin сохраняется под именем stdin без расширения, и в name для него тоже указывают имя без расширения. Размер size можно не передавать: Пачка возьмёт его из хранилища. Остальные типы файлов и их поля — в разделе Типы файлов.

Для низкоуровневого контроля доступна команда pachca files direct-url — она отправляет multipart-запрос на указанный URL с параметрами подписи.

Скачивание

Обычное вложение скачивается по ссылке из поля url сообщения — она прямая, и CLI для этого не нужен. Ссылка действует до 7 дней: если она ответила 403, запросите сообщение заново.

Команда pachca files get скачивает любое вложение, которое видно токену, а вложениям без прямой ссылки без неё не обойтись: в url таких файлов стоит адрес API. Так отдаются зашифрованные файлы и отправленные из безопасного контура пространства — подробнее в руководстве Шифрование и безопасный контур.

# Сохранить вложение по его идентификаторуpachca files get 3560 --save ./report.pdf # Превью документа вместо самого файлаpachca files get 3560 --target pdf_preview --save ./preview.pdf

Путь в --save обязателен: команда сохраняет файл на диск по этому пути. Токену нужен скоуп files:read. У зашифрованного файла --target не действует: приходит сам файл. Отказ 403 с кодом confidential_download_denied чаще всего значит, что адрес машины, на которой запущен CLI, не входит в безопасный контур.