安全文档 - 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" } |
| 文档内容* | String (Base64) | Excel 文档内容编码 Base64 | UEsDBBQABgAIAAAA... |
| 安全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
}
}