Шифрование рабочей тетради Excel с помощью API Aspose.Cells Cloud – примеры cURL и SDK
Этот REST API шифрует рабочую тетрадь Excel.
Необходимые условия: Перед вызовом этой конечной точки у вас должен быть действительный JWT-токен и рабочая тетрадь, загруженная в хранилище.
API PostEncryptDocument
POST https://api.aspose.cloud/v3.0/cells/{name}/encryption
Безопасность и аутентификация
API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.
Параметры запроса
| Имя параметра | Тип | Обязательный | Описание |
|---|---|---|---|
| folder | string | ✗ | Путь к папке с исходной рабочей тетрадью. |
| storageName | string | ✗ | Имя используемого хранилища. |
Параметр тела запроса
| Имя параметра | Тип | Обязательный | Описание |
|---|---|---|---|
| encryption | WorkbookEncryptionRequest | ✓ | Параметры шифрования рабочей тетради. |
WorkbookEncryptionRequest
| Имя параметра | Тип | Обязательный | Описание |
|---|---|---|---|
| EncryptionType | string | ✓ | Алгоритм шифрования. См. таблицу ниже с поддерживаемыми значениями и их описанием. |
| KeyLength | integer | ✗ | Длина ключа шифрования в битах (игнорируется для XOR и Compatible). |
| Password | string | ✓ | Пароль, используемый для шифрования. |
Значения EncryptionType
| Значение | Описание |
|---|---|
XOR |
Простой алгоритм XOR (устаревший, низкая защита). |
Compatible |
Совместимое шифрование Excel 97‑2003 (40 бит). |
EnhancedCryptographicProviderV1 |
AES‑128 с хэшем SHA‑1. |
StrongCryptographicProvider |
AES‑256 с хэшем SHA‑512 (самый надежный). |
Ответ
{
"Status":"OK",
"Code":200
}
Коды HTTP-статуса
| Код | Значение | Описание |
|---|---|---|
| 200 | OK | Фильтр успешно применён; ответ содержит сведения об операции. |
| 400 | Bad Request | Отсутствуют или некорректны параметры (например, неподдерживаемый тип файла). |
| 401 | Unauthorized | Некорректный или отсутствующий JWT-токен. |
| 413 | Payload Too Large | Загруженный файл превышает допустимый размер. |
| 500 | Internal Server Error | Непредвиденная ошибка сервера. |
Как использовать API PostEncryptDocument с SDK
Спецификация API PostEncryptDocument
Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.
Вы можете использовать инструмент командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как выполнить вызов облачного API с помощью cURL.
Использование SDK Aspose.Cells Cloud
Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах вашего проекта. Полный список SDK Aspose.Cells Cloud см. в репозитории GitHub.
Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK: