将 Excel 文件转换为不同格式

调用此接口前，请确保已获取有效的 JWT 令牌，并将源工作簿存储在受支持的存储位置（例如 Aspose Cloud 存储）。请将令牌置于 Authorization 请求头中；如有需要，还需指定 storageName 查询参数。

此 REST API 可将 Excel 文件转换为多种输出格式。

PutConvertWorkBook API

PUT https://api.aspose.cloud/v3.0/cells/convert

该请求为 HTTP PUT 请求，内容类型为 multipart（参见 RFC 2046 或 RFC 1341）。
multipart 主体的第一部分包含数据文件，第二部分包含保存选项。

安全与身份验证

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

查询参数

参数名称	类型	描述
`format`	string	目标文件格式（例如：CSV、XLS、HTML、PDF、XML、TXT、TIFF、PNG、JPG、GIF、EMF、BMP、MD、Numbers、WMF、SVG 等）。
`password`	string	打开源 Excel 文件所需的密码。
`outPath`	string	单个输出文件的完整路径（含文件名及扩展名），或生成多个文件时的文件夹路径。
`storageName`	string	源文件所在的存储名称。
`checkExcelRestriction`	bool	若为 true，则在修改单元格或相关对象前验证 Excel 限制条件。
`streamFormat`	string	输入文件流的格式。
`region`	string	应用于工作簿的区域设置。
`pageWideFitOnPerSheet`	bool	转换为 PDF 时，按工作表调整页面宽度以适应内容。
`pageTallFitOnPerSheet`	bool	转换为 PDF 时，按工作表调整页面高度以适应内容。
`sheetName`	string	待转换的工作表名称。
`pageIndex`	string	待转换页面的索引（需配合 `sheetName` 使用）。
`onePagePerSheet`	bool	若为 true，则每张工作表生成一页 PDF。
`AutoRowsFit`	bool	自动调整工作簿中所有行高。
`AutoColumnsFit`	bool	自动调整工作簿中所有列宽。

请求体参数

参数名称	类型	描述
`datafile`	data file	放置于 multipart 主体第一部分的 Excel 文件。
`SaveOptions`	object	放置于 multipart 主体第二部分的保存选项。

响应

{
    "Name": "ResponseFile",
    "DataType": {
        "Identifier": "File",
        "Reference": "Stream",
        "Name": "file"
    }
}

HTTP 状态码

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

如何结合 SDK 使用 PutConvertWorkBook API

PutConvertWorkBook API 规范

OpenAPI 规范定义了一个公开可访问的接口，允许直接从 Web 浏览器发起 REST 调用。

cURL 示例

curl -X PUT "https://api.aspose.cloud/v3.0/cells/convert?format=html" \
     -H "accept: multipart/form-data" \
     -H "Content-Type: multipart/form-data" \
     -H "x-aspose-client: Containerize.Swagger" \
     -d '{"File":{}}'

使用 Aspose.Cells Cloud SDK

使用 SDK 可加速开发进程，其自动处理底层细节，让您专注于业务逻辑。完整的 Aspose.Cells Cloud SDK 列表请参见 GitHub 仓库。

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

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