转换

Metadata API 是专为开发者打造的友好服务，只需一次 HTTP 请求，即可让您完全掌控电子表格文件的元数据。无论是处理传统办公格式如 Excel（.xlsx、.xls）、简单分隔文件如 CSV（.csv）和 TSV（.tsv），还是 Apple Numbers 文档（.numbers），该 API 都会抽象文件解析的复杂性，让您在毫秒级别内读取、添加或修改关键描述属性。想象一下能够批量处理数千份报告、研究数据集或财务报表，为每个文件注入一致的作者信息、标题、主题、描述、关键字列表，甚至由您应用定义的自定义标签集合。这种自动化水平不仅节省了大量手动编辑时间，还保证您交付给客户、合作者或归档系统的每个文件都携带用于索引、合规和可发现性的准确元数据。服务接受原始文件字节或指向云托管文档的 URL，然后返回一个新的完整文件，已应用请求的元数据更改且不改变原始数据布局或公式。

主要功能

因为该 API 是无状态的，您可以轻松将其集成到 CI/CD 流水线、服务器端批处理任务或客户端 JavaScript 小部件中，确保每次来自 Web 应用的导出或每次定期备份都包含正确的来源信息。安全性已内置：所有调用均通过 TLS 进行，负载端到端加密，API 支持 API‑key 或 OAuth 2.0 认证，让您只能向受信任的服务开放访问。底层引擎利用针对每种支持格式高度优化的解析库，保证即使是包含数百工作表的大型 Excel 工作簿也能快速处理；大多数普通请求在 200 毫秒以内完成。实际应用中，这意味着您可以在产品内构建一个无缝的 “添加元数据” 按钮，将文件发送到服务，获取已丰富的版本，并立即提供下载——用户无需离开界面。API 还返回详细的操作日志，开发者可以以编程方式验证预期字段是否已更新，必要时回滚更改，或根据自定义标签值触发后续处理步骤。通过提供统一、语言无关的 REST 端点，Metadata API 消除了开发者维护多个特定格式库的需求，降低了维护开销，并确保随着新电子表格标准的出现能够未来兼容。无论您是希望嵌入许可信息的 SaaS 供应商、编目数据集的研究机构，还是自动化文档合规的企业，此 API 都提供了快速、安全、可扩展的方式，只需一次简单调用即可丰富文件。

文档

参数

AppRequest.Metadata: 使用 PropertyName 和 PropertyValue
AppRequest.MetadataJson: 如果您未使用 Metadata 结构，则必须使用 JSON 数据类型。
UploadFileRequest.OperationId: 这些是您需要上传到我们在线服务的文件，您可以自行准备数据，但必须遵循 HTML 输入文件的标准。
UploadFileRequest.Files: 这些是您需要上传到我们在线服务的文件，您可以自行准备数据，但必须遵循 HTML 输入文件的标准。

使用端点

发送包含文件和访问令牌的请求元数据 API

curl -X 'POST' \ 'https://api.sheetize.cloud/metadata' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.Metadata={"propertyName":"string","propertyValue":"string"}' \ -F 'UploadFileRequest.OperationId=' \ -F 'UploadFileRequest.Files=@AFileName.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
服务将返回处理后文件的下载 URL，例如：

{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 }
发送包含文件名和文件夹名的请求到下载 API

curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken'
您将收到文件，可以直接使用或将其转发到工作流的下一步。