完全本地化地将 Excel 工作簿拆分为独立文件 —— 无需使用云存储。支持 30 多种文件格式输出,包括 PDF、CSV、JSON、ODS 和 XPS。
电子表格拆分 API
Web API
PUT https://api.aspose.cloud/v4.0/cells/split/spreadsheet
安全与身份验证
Aspose.Cells Cloud API 采用安全机制,需进行 基于 JWT 令牌的身份验证。
-H "Authorization: Bearer {access_token}"
请求参数:
| 参数名称 | 类型 | 路径/查询字符串/HTTP 请求体 | 描述 |
|---|---|---|---|
| Spreadsheet | 文件 | FormData | 待拆分的本地电子表格文件。支持格式包括 XLSX、XLS、ODS、CSV 等。该文件完全在服务器端处理,无需上传至云存储。 |
| from | 整数 | 查询字符串 | 待拆分工作表范围的起始索引(从 0 开始),例如 0 表示第一个工作表。 |
| to | 整数 | 查询字符串 | 待拆分工作表范围的结束索引(从 0 开始),例如 2 表示拆分第 0、1、2 个工作表。 |
| outFormat | 字符串 | 查询字符串 | 拆分后文件的输出格式。支持 30 多种格式,例如 PDF、CSV、JSON、XLSX、HTML。 |
| outPath | 字符串 | 查询字符串 | (可选) 拆分输出文件的本地保存路径。若未指定,则保存至默认临时目录。 |
| outStorageName | 字符串 | 查询字符串 | 用于组织输出文件的存储标识符。在本地处理模式下,通常指基于会话或用户自定义的存储标签。 |
| fontsLocation | 字符串 | 查询字符串 | (可选) 指定本地或自定义字体目录,以确保在导出为 PDF 或图像格式时实现准确的文本渲染。 |
| region | 字符串 | 查询字符串 | (可选) 设置输出文件中数字、日期和货币格式的区域设置(例如 "zh-CN"、"en-US")。 |
| password | 字符串 | 查询字符串 | (可选) 若上传的电子表格受密码保护,请提供密码以打开并处理该文件。 |
响应
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
可直接从响应中下载文件,或保存至 outPath 指定的位置。
成功响应详情
| 状态码 | Content-Type | 描述 |
|---|---|---|
| 200 OK | application/octet-stream |
拆分后工作簿文件的二进制流。 |
HTTP 状态码
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK(成功) | 拆分操作成功;响应包含操作详情。 |
| 400 | Bad Request(错误请求) | 缺少或无效的参数(例如不支持的文件类型)。 |
| 401 | Unauthorized(未授权) | JWT 令牌无效或缺失。 |
| 413 | Payload Too Large(请求实体过大) | 上传文件超出大小限制。 |
| 500 | Internal Server Error(内部服务器错误) | 服务器发生意外错误。 |
电子表格拆分 API 适用场景
- 部门数据分发:将包含多个部门数据的统一工作簿拆分为各部门专用文件。
- 区域报告分发:将全国销售报表拆分为多个区域报告文件。
- 客户数据脱敏分发:将包含敏感信息的工作簿拆分为客户可见的脱敏文件。
- 周期性报告拆分:每月自动将汇总报告拆分为周报或日报。
- 多格式分发:同时将单个 Excel 文件拆分为 PDF、CSV、JSON 等多种格式版本。
- 模板化拆分:根据预定义模板将数据文件拆分为标准化输出文件。
- 数据源预处理:在将数据加载至数据库前,将 Excel 文件拆分为标准化 CSV 文件。
- API 数据准备:将大型数据集拆分为适合 API 传输的小型数据块。
为何应使用电子表格拆分 API?
- 开发人员友好:Aspose.Cells Cloud 提供多种编程语言的 SDK 库,便于快速开发,并提供详尽文档。相比自定义图表渲染方案,显著减少开发工作量。
- 降低人力成本:减少专职文档整合岗位的需求。
- 按需付费:无需前期投入;仅对实际调用的 API 请求付费。
- 零维护成本:无需维护服务器、更新软件或处理兼容性问题。
- 保留复杂 Excel 格式:将格式保留在通用 PDF 格式中,便于跨平台访问。
如何使用 SDK 调用电子表格拆分 API
拆分电子表格 API 规范
电子表格拆分 API 规范 提供公开可访问的编程接口,允许直接从 Web 浏览器发起 REST 请求。 您可使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何通过 cURL 调用 Cloud API。
使用 Aspose.Cells Cloud SDK
使用 SDK 是最快捷的开发方式,它屏蔽了底层细节,使您能用简短代码将电子表格拆分为独立文件。
请查阅 GitHub 仓库,获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用不同语言的 SDK 调用 Aspose.Cells Web 服务: