跳到主要内容

安全文档 - Excel API

PDF4me 安全 Excel 使您能够对以下内容应用密码保护 Excel 多层级的文件。 API 该服务支持文件加密(密码打开)、工作簿结构保护(防止工作表修改)和工作表内容保护(防止单元格编辑),并提供灵活的密码层级结构和保护类型(内容、对象、方案、全部)。 API 接收 Excel 通过文档内容 REST API 利用电话 Base64 用于安全传输的编码。此解决方案非常适合机密数据保护、模板安全和受控访问工作流程。

相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间,您可以浏览 PDF4me 博客,查看适用于各平台的教程和工作流程。
访问博客

验证您的身份 API 要求

请包含您的 API 请求中用于身份验证的密钥 PDF4me REST API

主要特点

  • 三重防护等级文件加密、工作簿结构、工作表内容
  • 独立密码:为每个安全级别使用不同的密码
  • 密码回退:当未提供关卡特定密码时,使用主密码作为备用密码。
  • 灵活选择工作表保护特定工作表或所有工作表
  • 保护类型选项内容、对象、场景或全部(综合)
  • 基于 0 的索引工作表索引采用从 0 开始的编号(0 = 第一个工作表)

REST API 端点

  • 方法: POST
  • 终点: office/ApiV2Excel/ExcelSecure

REST API 参数

重要的: 标有星号 (*) 的参数为必填项。所有请求均使用 文档文档内容, 和 安全Excel操作操作特定参数(密码、保护工作簿等)是操作对象的属性。

必需参数(根级别)

范围类型描述例子
文档*Object文件参考 姓名Excel 文件名){ "Name": "data.xlsx" }
文档内容*StringBase64Excel 文档内容编码 Base64UEsDBBQABgAIAAAA...
安全Excel操作*Object操作配置(密码、保护级别、工作表选择)请参见下方的有效载荷示例。

可选参数(位于 secureExcelAction 内部)

范围类型描述例子
密码String文件加密密码(级别 1)。如果工作簿/工作表密码为空,则也用作工作簿/工作表保护的备用密码。MyPassword123
保护工作簿Boolean启用工作簿结构保护(级别 2)。默认值:否true
保护工作簿密码String工作簿保护密码。备用密码:如果为空则使用密码。StructurePass
保护工作表Boolean启用工作表内容保护(级别 3)。默认值:否true
工作表保护类型String内容对象场景, 或者 全部默认值:全部All
工作表保护密码String工作表保护密码。备用密码:如果为空则使用密码。EditPass
工作表名称String以逗号分隔的工作表名称,用于保护;空值表示全部Sheet1,Summary
工作表索引String以逗号分隔的工作表索引(从 0 开始);空索引表示全部0,2
文化名称String加工文化代码en-US

输出

API 返回受密码保护的内容 Excel 以文件形式 Base64-编码字符串 JSON 格式 (文档,文件名,成功,错误消息)。

请求示例

标题

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

有效载荷(基本)

{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"secureExcelAction": {
"password": "MyPassword123",
"protectWorkbook": true,
"protectWorksheets": true
}
}

代码示例

获取帮助