Dropbox
Загрузка, скачивание, поиск и ссылки Dropbox в процессах Pailot
Dropbox — облачное хранилище файлов. Блок ходит в API (Application Programming Interface — программный интерфейс): загрузка, скачивание, папки, поиск и общие ссылки.
С Dropbox в Pailot вы можете:
- Загружать файл (base64), скачивать по пути и получать временную ссылку (~4 часа)
- Смотреть содержимое папки, создавать папки, копировать, перемещать и удалять (в корзину)
- Читать метаданные и искать по запросу и расширениям
- Создавать общую ссылку: public, team_only или password
Подключение — через OAuth (вход по разрешению сервиса). Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Загрузить файл в Dropbox.
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь в Dropbox, куда сохранить файл (например, /folder/document.pdf) |
fileContent | string | Да | Содержимое файла в base64 |
fileName | string | Нет | Имя файла (если path указывает на папку) |
mode | string | Нет | Режим записи: add (по умолчанию) или overwrite |
autorename | boolean | Нет | Переименовать файл при конфликте имени |
mute | boolean | Нет | Не уведомлять пользователя о загрузке |
| Параметр | Тип | Описание |
|---|
file | object | Метаданные загруженного файла |
↳ id | string | Уникальный идентификатор файла |
↳ name | string | Имя файла |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
↳ size | number | Размер в байтах |
↳ client_modified | string | Время изменения на клиенте |
↳ server_modified | string | Время изменения на сервере |
↳ rev | string | Идентификатор ревизии |
↳ content_hash | string | Хеш содержимого |
Скачать файл и получить временную ссылку.
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла (например, /folder/document.pdf) |
| Параметр | Тип | Описание |
|---|
file | object | Метаданные файла |
↳ id | string | Уникальный идентификатор файла |
↳ name | string | Имя файла |
↳ path_display | string | Отображаемый путь |
↳ size | number | Размер в байтах |
temporaryLink | string | Временная ссылка на скачивание (около 4 часов) |
content | string | Содержимое файла в base64 (если запрошено) |
Список файлов и папок в каталоге.
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь папки ("" — корень) |
recursive | boolean | Нет | Обходить вложенные папки |
includeDeleted | boolean | Нет | Включать удалённые объекты |
includeMediaInfo | boolean | Нет | Включать медиаданные фото и видео |
limit | number | Нет | Максимум результатов (по умолчанию 500) |
| Параметр | Тип | Описание |
|---|
entries | array | Файлы и папки в каталоге |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя файла или папки |
↳ path_display | string | Отображаемый путь |
↳ size | number | Размер в байтах (только файлы) |
cursor | string | Курсор следующей страницы |
hasMore | boolean | Есть ли ещё результаты |
Создать папку.
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь новой папки (например, /new-folder) |
autorename | boolean | Нет | Переименовать папку при конфликте имени |
| Параметр | Тип | Описание |
|---|
folder | object | Метаданные созданной папки |
↳ id | string | Уникальный идентификатор папки |
↳ name | string | Имя папки |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
Удалить файл или папку (в корзину).
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла или папки |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные удалённого объекта |
↳ name | string | Имя объекта |
↳ path_display | string | Отображаемый путь |
deleted | boolean | Удаление удалось |
Скопировать файл или папку.
| Параметр | Тип | Обязательный | Описание |
|---|
fromPath | string | Да | Исходный путь |
toPath | string | Да | Путь назначения |
autorename | boolean | Нет | Переименовать при конфликте в назначении |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные копии |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя копии |
↳ path_display | string | Отображаемый путь |
↳ size | number | Размер в байтах (только файлы) |
Переместить или переименовать файл или папку.
| Параметр | Тип | Обязательный | Описание |
|---|
fromPath | string | Да | Исходный путь |
toPath | string | Да | Путь назначения |
autorename | boolean | Нет | Переименовать при конфликте в назначении |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные перемещённого объекта |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя объекта |
↳ path_display | string | Отображаемый путь |
↳ size | number | Размер в байтах (только файлы) |
Метаданные файла или папки.
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла или папки |
includeMediaInfo | boolean | Нет | Включать медиаданные фото и видео |
includeDeleted | boolean | Нет | Включать удалённые объекты |
| Параметр | Тип | Описание |
|---|
metadata | object | Метаданные объекта |
↳ id | string | Уникальный идентификатор |
↳ name | string | Имя объекта |
↳ path_display | string | Отображаемый путь |
↳ path_lower | string | Путь в нижнем регистре |
↳ size | number | Размер в байтах (только файлы) |
↳ client_modified | string | Время изменения на клиенте |
↳ server_modified | string | Время изменения на сервере |
↳ rev | string | Идентификатор ревизии |
↳ content_hash | string | Хеш содержимого |
Создать общую ссылку на файл или папку.
| Параметр | Тип | Обязательный | Описание |
|---|
path | string | Да | Путь файла или папки |
requestedVisibility | string | Нет | Видимость: public, team_only или password |
linkPassword | string | Нет | Пароль ссылки (если видимость password) |
expires | string | Нет | Срок действия в ISO 8601 (например, 2025-12-31T23:59:59Z) |
| Параметр | Тип | Описание |
|---|
sharedLink | object | Созданная ссылка |
↳ url | string | URL ссылки |
↳ name | string | Имя объекта |
↳ path_lower | string | Путь в нижнем регистре |
↳ expires | string | Срок действия, если задан |
↳ link_permissions | object | Права ссылки |
Поиск файлов и папок.
| Параметр | Тип | Обязательный | Описание |
|---|
query | string | Да | Поисковый запрос |
path | string | Нет | Ограничить поиск папкой |
fileExtensions | string | Нет | Расширения через запятую (например, pdf,xlsx) |
maxResults | number | Нет | Максимум результатов (по умолчанию 100) |
| Параметр | Тип | Описание |
|---|
matches | array | Результаты поиска |
↳ match_type | object | Тип совпадения: filename, content или оба |
↳ metadata | object | Метаданные файла или папки |
hasMore | boolean | Есть ли ещё результаты |
cursor | string | Курсор следующей страницы |
