Aspose.Cells Cloud – 将 Excel 工作簿转换为 PDF、CSV、HTML 等格式（GET /cells/{name}）

此 REST API 可将 Excel 工作簿以不同格式检索。

GetWorkBook API

GET https://api.aspose.cloud/v3.0/cells/{name}

安全与身份验证

Aspose.Cells Cloud API 采用安全机制，需使用 基于 JWT 令牌的身份验证。

查询参数

参数名称 类型 描述 默认值
format string 目标文件格式（例如 CSV、XLS、HTML、MHTML、ODS、PDF、XML、TXT、TIFF、XLSB、XLSM、XLSX、XLTM、XLTX、XPS、PNG、JPG、GIF、EMF、BMP、MD、Numbers、WMF、SVG 等）。 –
password string 打开 Excel 文件所需的密码。 –
isAutoFit bool 自动调整行高与列宽。 false
onlySaveTable bool 设置为 true 时，仅保存表格数据。接受 true 或 false。 false
outPath string 保存结果的路径。单个文件需包含文件名及扩展名；多个文件时仅指定文件夹。 –
outStorageName string 输出文件保存到的存储名称。 –
checkExcelRestriction bool 修改单元格或相关对象时检查 Excel 限制。 false
region string 应用于工作簿的区域设置。 –
pageWideFitOnPerSheet bool 转换为 PDF 时，将页面宽度适配到每张工作表。 false
pageTallFitOnPerSheet bool 转换为 PDF 时，将页面高度适配到每张工作表。 false
onePagePerSheet bool 每个工作表生成一个 PDF 页面。 false
folder string 原始工作簿所在的文件夹路径。 –
storageName string 源文件所在的存储名称。 –

响应

成功（200）

  • 若省略 format 查询参数，API 返回包含工作簿结构信息的 Workbook 对象。

  • 若 format 查询参数指定文件类型，API 返回所请求格式的已转换文件。

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="book1.pdf"
Content-Length: 123456

（二进制 PDF 数据）

HTTP 状态码

状态码 含义 描述
200 OK（成功） 成功应用筛选条件；响应包含操作详情。
400 Bad Request（错误请求） 缺少或参数无效（例如不支持的文件类型）。
401 Unauthorized（未授权） JWT 令牌无效或缺失。
413 Payload Too Large（请求实体过大） 上传文件超过大小限制。
500 Internal Server Error（内部服务器错误） 意外服务器错误。

注意事项：

  • 大型工作簿转换可能耗时较长；建议增加请求超时时间。
  • 某些格式（例如 ODS）不支持某些 Excel 功能（例如宏）。

如何通过 SDK 使用 GetWorkBook API

前提条件：

  • 通过 Aspose.Cells 身份验证流程获取有效的 JWT 访问令牌。
  • 源工作簿需存储在受支持的 Aspose 存储中，或直接在请求中提供。
  • 确保 API 版本（v3.0）与最新发布的版本一致。

GetWorkBook API 规范

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

示例请求

您可使用 cURL 命令行工具访问 Aspose.Cells Web 服务。以下示例展示了一个包含必需授权标头的正确 GET 请求。

使用 Aspose.Cells Cloud SDK

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

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

另请参阅

最后更新时间：2024-12-01

将 Excel 转换为 HTML 保存 Excel 工作簿 – Aspose.Cells Cloud API