高级 Excel 文件转换 – Aspose.Cells Cloud API 指南

高级 Excel 转换云 API

高级转换(Advanced Convert)功能可将 Excel 工作簿转换为多种输出格式(如 PDF、HTML、CSV 等),并允许您精细控制页面设置、保存选项和打印设置。

前置条件 / 身份验证
使用该接口前,您需从 Aspose.Cells Cloud 获取访问令牌,并以 Bearer Token 形式置于 Authorization 请求头中。

API 参考

  • 方法: PUT
  • 端点: /cells/convert
  • 参数:
    • format(字符串,必填)– 目标输出格式(如 pdfhtml)。
    • outPath(字符串,可选)– 转换后文件在云存储中的保存路径。
    • options(对象,可选)– JSON 对象,包含高级转换选项,例如 pageSetup(页面设置)、saveOptions(保存选项)和 printSettings(打印设置)。
  • 请求体示例:
    {
      "format": "pdf",
      "outPath": "output/converted.pdf",
      "options": {
        "pageSetup": {
          "orientation": "Landscape",
          "paperSize": "A4"
        },
        "saveOptions": {
          "compress": true
        },
        "printSettings": {
          "printHeadings": false
        }
      }
    }
    
  • 响应:
    • 200 OK – 转换成功;响应包含转换后的文件流或已保存文件的引用路径。
    • 400 Bad Request – 参数无效或请求体格式错误。
    • 401 Unauthorized – 身份验证失败或缺少访问令牌。
    • 500 Internal Server Error – 服务端在转换过程中发生错误。

HTTP 状态码

状态码 含义 描述
200 OK(成功) 转换成功;响应包含操作详情。
400 Bad Request 参数缺失或无效(例如不支持的文件类型)。
401 Unauthorized JWT 令牌无效或缺失。
413 Payload Too Large 上传文件超过大小限制。
500 Internal Server Error 服务端发生意外错误。

注意事项

  • 某些输出格式存在特定限制(例如 HTML 转换不保留宏)。详情请参阅对应格式的文档说明。

从多种数据源加载电子表格文件的能力

设置页面设置与保存选项

云 SDK 开发套件家族

使用 SDK 可加速开发进程,屏蔽底层细节,让您专注于业务逻辑与项目任务。欢迎访问 GitHub 仓库 查看 Aspose.Cells Cloud 的完整 SDK 列表。

以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells Web 服务: