Руководства

Файлы

Команда pachca upload автоматически получает подпись через POST /uploads и загружает файл на S3 — не нужно вручную копировать 7 параметров подписи:

# Загрузить файлpachca upload photo.jpg # Из stdincat data.csv | pachca upload -

Команда возвращает key — используйте его в поле files[].key при создании сообщений:

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

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

Скачивание

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

Команда 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.