AACFlow

Box

Управление файлами, папками и электронными подписями с помощью Box

Box — это ведущая платформа управления облачным контентом и обмена файлами, которой доверяют предприятия по всему миру для безопасного хранения, управления и совместной работы над файлами. Box предоставляет надежные API для автоматизации файловых операций и интеграции с бизнес-процессами, включая Box Sign для нативных электронных подписей.

С интеграцией Box в AACFlow вы можете:

  • Загружать файлы: Загружать документы, изображения и другие файлы в любую папку Box
  • Скачивать файлы: Получать содержимое файлов из Box для обработки в ваших рабочих процессах
  • Получать информацию о файлах: Получать доступ к подробным метаданным, включая размер, владельца, временные метки, теги и общие ссылки
  • Просматривать содержимое папок: Просматривать файлы и папки с поддержкой сортировки и пагинации
  • Создавать папки: Организовывать хранилище Box, создавая новые папки программно
  • Удалять файлы и папки: Удалять контент с опциональным рекурсивным удалением для папок
  • Копировать файлы: Дублировать файлы между папками с опциональным переименованием
  • Искать: Находить файлы и папки по имени, содержимому, расширению или местоположению
  • Обновлять метаданные файлов: Переименовывать, перемещать, добавлять описания или тегировать файлы
  • Создавать запросы на подпись: Отправлять документы для электронной подписи с одним или несколькими подписывающими
  • Отслеживать статус подписания: Мониторить прогресс запросов на подпись
  • Просматривать запросы на подпись: Просматривать все запросы на подпись с пагинацией на основе маркеров
  • Отменять запросы на подпись: Отменять ожидающие запросы на подпись, которые больше не нужны
  • Повторно отправлять напоминания о подписи: Отправлять уведомления-напоминания подписывающим, которые не завершили подписание

Эти возможности позволяют вашим агентам AACFlow автоматизировать операции Box непосредственно в ваших рабочих процессах — от организации документов и распространения контента до обработки загруженных файлов, управления рабочими процессами электронной подписи для предложений о работе и контрактов, а также поддержания структурированного облачного хранилища в рамках ваших бизнес-процессов.

Инструкции по использованию

Интегрируйте Box в ваш рабочий процесс для управления файлами, папками и электронными подписями. Загружайте и скачивайте файлы, ищите контент, создавайте папки, отправляйте документы для электронной подписи, отслеживайте статус подписания и многое другое.

Инструменты

box_upload_file

Загрузить файл в папку Box

Входные параметры

ПараметрТипОбязательныйОписание
parentFolderIdstringДаID папки для загрузки файла (используйте "0" для корневой папки)
filefileНетФайл для загрузки (объект UserFile)
fileContentstringНетУстаревший: содержимое файла в кодировке base64
fileNamestringНетОпциональное переопределение имени файла

Выходные данные

ПараметрТипОписание
idstringID файла
namestringИмя файла
sizenumberРазмер файла в байтах
sha1stringSHA1-хэш содержимого файла
createdAtstringВременная метка создания
modifiedAtstringВременная метка последнего изменения
parentIdstringID родительской папки
parentNamestringИмя родительской папки

box_download_file

Скачать файл из Box

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для скачивания

Выходные данные

ПараметрТипОписание
filefileСкачанный файл, сохраненный в файлах выполнения
contentstringСодержимое файла в кодировке base64

box_get_file_info

Получить подробную информацию о файле в Box

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для получения информации

Выходные данные

ПараметрТипОписание
idstringID файла
namestringИмя файла
sizenumberРазмер файла в байтах
sha1stringSHA1-хэш содержимого файла
createdAtstringВременная метка создания
modifiedAtstringВременная метка последнего изменения
parentIdstringID родительской папки
parentNamestringИмя родительской папки
ownerIdstringID владельца файла
ownerNamestringИмя владельца файла
descriptionstringОписание файла
tagsarrayТеги файла
sharedLinkstringОбщая ссылка на файл (если доступна)
patharrayПуть к файлу в виде массива объектов папок
idstringID папки в пути
namestringИмя папки в пути

box_list_folder

Просмотреть содержимое папки Box

Входные параметры

ПараметрТипОбязательныйОписание
folderIdstringДаID папки для просмотра (используйте "0" для корневой папки)
limitnumberНетМаксимальное количество элементов для возврата (по умолчанию 100, максимум 1000)
offsetnumberНетСмещение для пагинации (по умолчанию 0)
sortstringНетПоле для сортировки: name, date, size (по умолчанию name)
directionstringНетНаправление сортировки: ASC или DESC (по умолчанию ASC)

Выходные данные

ПараметрТипОписание
itemsarrayМассив элементов (файлов и папок)
typestringТип элемента: file или folder
idstringID элемента
namestringИмя элемента
sizenumberРазмер (только для файлов)
createdAtstringВременная метка создания
modifiedAtstringВременная метка последнего изменения
totalCountnumberОбщее количество элементов в папке
offsetnumberТекущее смещение
limitnumberТекущий лимит

box_create_folder

Создать новую папку в Box

Входные параметры

ПараметрТипОбязательныйОписание
parentFolderIdstringДаID родительской папки (используйте "0" для корневой папки)
namestringДаИмя новой папки

Выходные данные

ПараметрТипОписание
idstringID созданной папки
namestringИмя папки
createdAtstringВременная метка создания
modifiedAtstringВременная метка последнего изменения
parentIdstringID родительской папки
parentNamestringИмя родительской папки

box_delete_file

Удалить файл из Box

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для удаления

Выходные данные

ПараметрТипОписание
deletedbooleanБыл ли файл удален

box_delete_folder

Удалить папку из Box

Входные параметры

ПараметрТипОбязательныйОписание
folderIdstringДаID папки для удаления
recursivebooleanНетРекурсивно удалить все содержимое папки (по умолчанию false)

Выходные данные

ПараметрТипОписание
deletedbooleanБыла ли папка удалена

box_copy_file

Копировать файл в другую папку Box

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для копирования
destinationFolderIdstringДаID папки назначения
newNamestringНетНовое имя для копии файла

Выходные данные

ПараметрТипОписание
idstringID скопированного файла
namestringИмя скопированного файла
sizenumberРазмер файла в байтах
sha1stringSHA1-хэш содержимого файла
createdAtstringВременная метка создания
modifiedAtstringВременная метка последнего изменения
parentIdstringID родительской папки
parentNamestringИмя родительской папки

Поиск файлов и папок в Box

Входные параметры

ПараметрТипОбязательныйОписание
querystringДаПоисковый запрос
scopestringНетОбласть поиска: user_content, enterprise_content (по умолчанию user_content)
fileExtensionsstringНетРасширения файлов для фильтрации через запятую (например, pdf,docx)
limitnumberНетМаксимальное количество результатов (по умолчанию 30, максимум 200)
offsetnumberНетСмещение для пагинации (по умолчанию 0)

Выходные данные

ПараметрТипОписание
resultsarrayМассив результатов поиска
typestringТип элемента: file или folder
idstringID элемента
namestringИмя элемента
sizenumberРазмер (только для файлов)
createdAtstringВременная метка создания
modifiedAtstringВременная метка последнего изменения
patharrayПуть к элементу
totalCountnumberОбщее количество результатов
offsetnumberТекущее смещение
limitnumberТекущий лимит

box_update_file

Обновить метаданные файла в Box

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для обновления
namestringНетНовое имя файла
descriptionstringНетНовое описание файла
parentFolderIdstringНетНовая родительская папка (для перемещения файла)
tagsstringНетJSON-массив тегов для добавления к файлу

Выходные данные

ПараметрТипОписание
idstringID файла
namestringИмя файла
descriptionstringОписание файла
tagsarrayТеги файла
parentIdstringID родительской папки
parentNamestringИмя родительской папки

box_create_sign_request

Создать запрос на электронную подпись с помощью Box Sign

Входные параметры

ПараметрТипОбязательныйОписание
fileIdstringДаID файла для подписания
signersstringДаJSON-массив подписывающих (например, [\{"email":"signer@example.com","role":"signer"\}])
subjectstringНетТема письма с запросом на подпись
messagestringНетСообщение для подписывающих
redirectUrlstringНетURL для перенаправления после подписания
expiresInDaysnumberНетКоличество дней до истечения срока запроса (по умолчанию 30)

Выходные данные

ПараметрТипОписание
signRequestIdstringID запроса на подпись
statusstringСтатус запроса: converting, created, sent, viewed, signed, cancelled, declined, error
signersarrayИнформация о подписывающих
emailstringEmail подписывающего
rolestringРоль подписывающего: signer, approver, etc.
statusstringСтатус подписывающего
createdAtstringВременная метка создания
expiresAtstringВременная метка истечения срока

box_get_sign_request

Получить информацию о запросе на электронную подпись

Входные параметры

ПараметрТипОбязательныйОписание
signRequestIdstringДаID запроса на подпись

Выходные данные

ПараметрТипОписание
signRequestIdstringID запроса на подпись
statusstringСтатус запроса: converting, created, sent, viewed, signed, cancelled, declined, error
signersarrayИнформация о подписывающих
emailstringEmail подписывающего
rolestringРоль подписывающего: signer, approver, etc.
statusstringСтатус подписывающего
createdAtstringВременная метка создания
expiresAtstringВременная метка истечения срока
completedAtstringВременная метка завершения (если применимо)
declinedReasonstringПричина отказа (если применимо)

box_list_sign_requests

Просмотреть все запросы на электронную подпись

Входные параметры

ПараметрТипОбязательныйОписание
limitnumberНетМаксимальное количество запросов для возврата (по умолчанию 100, максимум 500)
markerstringНетМаркер для пагинации (из предыдущего ответа)

Выходные данные

ПараметрТипОписание
signRequestsarrayМассив запросов на подпись
signRequestIdstringID запроса на подпись
statusstringСтатус запроса
createdAtstringВременная метка создания
expiresAtstringВременная метка истечения срока
nextMarkerstringМаркер для следующей страницы (если есть)

box_cancel_sign_request

Отменить запрос на электронную подпись

Входные параметры

ПараметрТипОбязательныйОписание
signRequestIdstringДаID запроса на подпись для отмены

Выходные данные

ПараметрТипОписание
cancelledbooleanБыл ли запрос отменен

box_resend_sign_reminder

Повторно отправить напоминание о подписи

Входные параметры

ПараметрТипОбязательныйОписание
signRequestIdstringДаID запроса на подпись
signerEmailstringДаEmail подписывающего для отправки напоминания

Выходные данные

ПараметрТипОписание
resentbooleanБыло ли напоминание отправлено повторно

On this page

Начните создавать сегодня
Нам доверяют более 100 000 разработчиков.
SaaS-платформа для создания AI-агентов и управления агентным workforce.
Начать