使用 Smart Marker 模板构建 Excel 报表 —— Aspose.Cells Cloud API 指南
Contents
[
Hide
]
此 REST API 使用 Smart Marker 模板创建工作簿。
工作簿 SmartMarker API
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
安全与认证
Aspose.Cells Cloud API 是安全的，需要使用 基于 JWT 令牌的认证。
什么是 Smart Marker（智能标记）？
Smart Marker（智能标记）是一种占位符语法，用于将 XML（或 JSON）文件中的数据字段映射到 Excel 模板中的单元格。在运行时，Aspose.Cells 会将这些标记替换为对应的数据，从而实现以编程方式生成完整填充的报表。
查询参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| outPath | string | 生成的工作簿将被保存的目标路径。 |
| folder | string | 包含原始工作簿的文件夹。 |
| storageName | string | 要使用的存储服务名称。 |
请求体参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| xmlFile | file | 随请求一起上传的 Smart Marker XML 数据文件。 |
响应
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
注意事项 / 限制：
- 该 API 仅支持最大 50 MB 的 Excel 文件。
- 仅支持 .xlsx、.xlsm 和 .xlsb 格式。
- 每个账户的速率限制为 每秒 20 个请求。
HTTP 状态码
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK（成功） | 成功应用筛选；响应包含操作详情。 |
| 400 | Bad Request（错误请求） | 缺少或无效参数（例如，不支持的文件类型）。 |
| 401 | Unauthorized（未授权） | JWT 令牌无效或缺失。 |
| 413 | Payload Too Large（载荷过大） | 上传文件超出大小限制。 |
| 500 | Internal Server Error（内部服务器错误） | 服务器端意外错误。 |
如何使用工作簿 SmartMarker API
工作簿 SmartMarker API 规范
OpenAPI 规范定义了一个公开可访问的编程接口，可让您直接从 Web 浏览器发起 REST 调用。
使用 Aspose.Cells Cloud SDK
您可以使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用 Cloud API。
快速单行示例
curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"
错误处理
| HTTP 状态码 | 描述 | 典型原因 |
|---|---|---|
| 400 | Bad Request（错误请求） | 缺少模板、XML 格式错误或参数无效。 |
| 401 | Unauthorized（未授权） | 无效或缺失的认证令牌。 |
| 404 | Not Found（未找到） | 指定的工作簿或存储位置不存在。 |
| 500 | Internal Server Error（内部服务器错误） | 服务器端意外失败。 |
错误响应示例（400）
{
"Code": 400,
"Message": "XML 数据文件缺失或格式错误。"
}
云 SDK 家族
使用 SDK 是加速开发的最佳方式。SDK 会处理底层细节，让您专注于项目任务。请查看 GitHub 仓库，了解 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用各种 SDK 调用 Aspose.Cells Web 服务：