Пакетная защита файлов Excel

Это REST API позволяет выполнять пакетную защиту подходящих файлов Excel.

REST API

POST http://api.aspose.cloud/v3.0/cells/batch/protect

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификации на основе токена JWT.

Параметры запроса

Имя параметра	Тип	Местоположение	Описание
batchProtectRequest	BatchProtectRequest	body	JSON-полезная нагрузка, определяющая исходную папку, условия отбора, тип защиты, пароль и выходную папку.

Свойства BatchProtectRequest

Имя	Тип	Описание	Примечания
SourceFolder	string	Папка, содержащая исходные файлы Excel.	необязательно
MatchCondition	MatchConditionRequest	Критерии, используемые для отбора файлов для защиты.	необязательно
ProtectionType	string	Тип применяемой защиты (например, `All`, `ReadOnly`).	необязательно
Password	string	Пароль, устанавливаемый для защищённых файлов.	необязательно
OutFolder	string	Папка назначения для защищённых файлов.	необязательно

Свойства MatchConditionRequest

Имя	Тип	Описание	Примечания
RegexPattern	string	Регулярное выражение, используемое для сопоставления имён файлов.	необязательно
FullMatchConditions	string[]	Список точных условий по имени файла.	необязательно

Параметр тела запроса

Имя параметра	Тип	Описание
data	file	Бинарное содержимое файла рабочей книги для создания.

Ответ

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

Коды HTTP-статуса

Код	Значение	Когда возвращается
200 OK	Рабочая книга успешно создана	Нормальный сценарий выполнения
201 Created	Рабочая книга создана (альтернативный ответ)	Когда API возвращает статус «создано»
400 Bad Request	Недопустимые параметры	Ошибка со стороны клиента
401 Unauthorized	Отсутствующий или недействительный токен	Ошибка аутентификации
409 Conflict	Файл существует, а `isWriteOver=false`	Конфликт с существующим файлом

Как использовать API PostProtectConvert с SDK

Спецификация API PostProtectConvert

Спецификация OpenAPI определяет общедоступное программное интерфейсное определение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать инструмент командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. Пример ниже показывает, как выполнить вызов облачного API с помощью cURL.

Запрос

curl -v "http://api.aspose.cloud/v3.0/cells/batch/protect" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-D "{\"SourceFolder\":\"CellsTests\",\"OutFolder\":\"Output\",\"MatchCondition\":{\"RegexPattern\":\"(^Book)(.+)(xlsx$)\"},\"Password\":\"123456\",\"ProtectionType\":\"All\"}"

Ответ

{
  "Code": 200,
  "Status": "OK"
}

Использование SDK Aspose.Cells Cloud

Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали и позволяет сосредоточиться на задачах вашего проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.

Примеры кода ниже показывают, как выполнять вызовы веб-сервисов Aspose.Cells с использованием различных SDK: