使用 Aspose.Cells Cloud API 加密 Excel 工作簿——cURL 与 SDK 示例
Contents
[
Hide
]
此 REST API 可用于加密 Excel 工作簿。
前提条件：调用此接口前，您必须拥有有效的 JWT 令牌，并已将工作簿上传至存储空间。
PostEncryptDocument API
POST https://api.aspose.cloud/v3.0/cells/{name}/encryption
安全与身份验证
Aspose.Cells Cloud API 安全可靠，需采用 基于 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 |
使用 SHA‑1 哈希的 AES‑128 加密。 |
StrongCryptographicProvider |
使用 SHA‑512 哈希的 AES‑256 加密（最强）。 |
响应
{
"Status":"OK",
"Code":200
}
HTTP 状态码说明
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK（成功） | 加密操作成功；响应中包含操作详情。 |
| 400 | Bad Request（错误请求） | 参数缺失或无效（例如不支持的文件类型）。 |
| 401 | Unauthorized（未授权） | JWT 令牌无效或缺失。 |
| 413 | Payload Too Large（载荷过大） | 上传文件超出大小限制。 |
| 500 | Internal Server Error（内部服务器错误） | 服务器发生意外错误。 |
如何使用 SDK 调用 PostEncryptDocument API
PostEncryptDocument API 规范
OpenAPI 规范 定义了一个公开可访问的编程接口，支持您直接通过网页浏览器发起 REST 请求。
您可使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何通过 cURL 调用该 Cloud API。
使用 Aspose.Cells Cloud SDK
使用 SDK 是加速开发的最佳方式。SDK 将处理底层细节，使您能专注于项目任务本身。请查阅 GitHub 仓库 获取 Aspose.Cells Cloud SDK 完整列表。
以下代码示例展示了如何使用多种 SDK 调用 Aspose.Cells Web 服务：