Защита рабочей книги Excel с помощью API Aspose.Cells Cloud
Этот REST API защищает рабочую книгу Excel, позволяя вам надежно защитить её с помощью пароля и параметров защиты с использованием Aspose.Cells Cloud.
API PostProtectDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/protection
Безопасность и аутентификация
API Aspose.Cells Cloud являются защищенными и требуют аутентификации на основе JWT-токена.
Параметры запроса
| Имя параметра | Тип | Описание |
|---|---|---|
| folder | string | Папка, содержащая исходную рабочую книгу. (необязательно) |
| storageName | string | Имя хранилища. (необязательно; по умолчанию = “Default”) |
Параметры тела запроса
| Имя параметра | Тип | Описание |
|---|---|---|
| protection | WorkbookProtectionRequest | Объект, определяющий параметры защиты для рабочей книги. |
WorkbookProtectionRequest
| Имя параметра | Тип | Описание |
|---|---|---|
| ProtectionType | string | Тип применяемой защиты. Допустимые значения (без учета регистра): ALL, CONTENTS, NONE, OBJECTS, SCENARIOS, STRUCTURE, WINDOWS. |
| Password | string | Необязательный пароль для установки защиты. |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статусов
| Код | Значение | Описание |
|---|---|---|
| 200 | OK (Успешно) | Фильтр применён успешно; ответ содержит сведения о выполненной операции. |
| 400 | Bad Request (Неверный запрос) | Отсутствуют или недопустимы параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized (Неавторизовано) | Недействительный или отсутствующий JWT-токен. |
| 413 | Payload Too Large (Слишком большой полезный груз) | Загруженный файл превышает лимит размера. |
| 500 | Internal Server Error (Внутренняя ошибка сервера) | Непредвиденная ошибка сервера. |
Как использовать API PostProtectDocument с SDK
Необходимые условия
Перед вызовом API убедитесь, что вы выполнили следующие шаги:
- Получите JWT-токен доступа, следуя описанному в разделе «Безопасность и аутентификация» процессу аутентификации.
- Загрузите рабочую книгу в хранилище Aspose Cloud или подтвердите, что она уже существует в целевой папке.
- Знайте имя хранилища (по умолчанию —
"Default", если не указано иное) и точное имя файла, который необходимо защитить.
Спецификация API PostProtectDocument
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Пример: Защита рабочей книги с помощью cURL
-
Получите токен доступа, как описано в разделе Необходимые условия / Аутентификация.
-
Выполните запрос:
curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/protection?folder=MyFolder&storageName=MyStorage" \ -H "accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <access_token>" \ -d '{ "ProtectionType": "ALL", "Password": "aspose" }'В ответе будет возвращён объект со статусом, подтверждающим успешное применение защиты.
Использование SDK Aspose.Cells Cloud
Использование SDK — самый быстрый способ разработки приложений для Aspose.Cells Cloud. SDK скрывает низкоуровневые детали, позволяя сосредоточиться на бизнес-логике. Полный список SDK Aspose.Cells Cloud доступен в репозитории GitHub.
Следующие примеры кода демонстрируют вызов веб-служб Aspose.Cells с использованием различных SDK:
Пример полного ответа
{
"Status": "OK",
"Code": 200,
"Workbook": {
"Name": "test.xlsx",
"Path": "/MyFolder/test.xlsx",
"Protection": {
"ProtectionType": "ALL",
"Password": true
}
}
}