锁定 Excel 文件 – Aspose.Cells Cloud API 文档

API 版本： v3.0（当前版）

此 REST API 锁定 Excel 工作簿。

PostLock API

POST https://api.aspose.cloud/v3.0/cells/lock

前提条件 – 请求必须通过 HTTPS 发送，并在 Authorization 头中包含有效的 OAuth 2.0 Bearer 令牌。

请求参数如下：

参数名称	类型	位置	描述
file	文件	表单数据（multipart body）	待上传并锁定的 Excel 工作簿。
password	字符串	查询字符串	工作簿密码（可选）。

OpenAPI 规范定义了一个公开可访问的编程接口，可让您直接通过 Web 浏览器执行 REST 交互。

您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用云 API。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/lock?password=123456" \
  -X POST \
  -H "Content-Type: multipart/form-data" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <access_token>" \
  -F "file=@Sample.xlsx"

响应

{
  "Files": [
    {
      "Filename": "Sample.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

您可下载示例工作簿 — Sample.xlsx — 以测试该请求。

注意： 该 API 支持最大为 100 MB 的文件；更大的负载可能导致返回 413（请求实体过大）响应。

响应详情

字段	类型	描述
Filename	字符串	服务返回的已锁定工作簿的文件名。
FileSize	整数	已锁定文件的大小（单位：字节）。
FileContent	字符串（Base64）	以 Base64 字符串编码的已锁定工作簿内容。

要获取已锁定的工作簿，请将响应中的 FileContent 值从 Base64 解码，并使用响应中提供的 Filename 保存文件。

错误处理

– API 返回标准 HTTP 状态码（例如 400 Bad Request、401 Unauthorized、500 Internal Server Error），并附带一个包含 Code 和 Message 字段的 JSON 错误对象。

云 SDK 开发工具包（SDK Family）

使用 SDK 是加快开发速度的最佳方式。SDK 抽象了底层细节，使您能专注于项目任务本身。请查阅 GitHub 仓库以获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用多种 SDK 调用 Aspose.Cells Web 服务：

取消保护 Excel 工作簿 – Aspose.Cells Cloud API 修改 Excel 工作簿的密码保护