比较

欢迎使用 Comparison API 官方文档中心，这是一款专为简化电子表格版本控制而打造的解决方案，可将往往繁琐的工作流转变为高效、面向开发者的流程。无论您是对齐季度报告的数据分析师、跟踪预算修订的财务团队，还是在更大型数据管道中嵌入差异比对功能的软件工程师，该 API 都能够贴合您的需求，帮助您快速发现各类电子表格格式的变动。核心模型简洁而强大：您提供两个源文件——可以是 Apple Numbers、CSV/TSV 导出，或是常见的 Excel（.xlsx、.xls）文件——服务会返回一个结果文件，使用清晰的视觉标识标注每一处新增、删除和修改。对可读性的重视并非事后考虑；每项差异均以符合原生电子表格习惯的方式注释（颜色标记的单元格背景、批注气泡以及行列指示），以便最终用户在首选应用中打开结果文件后即可直观了解变更内容。除了基础的差异比对，API 还能保留原始的格式、公式和数据类型，确保输出的不仅是纯文本报告，而是一个可直接用于后续分析或分发的功能完整工作簿。安全性与性能贯穿每一次请求：所有文件传输均通过 TLS 1.3 加密，文件在具有限制内存的隔离容器中处理，且对 10 MB 以下的文件通常在一秒内返回结果，对于更大的数据集亦可通过分块流式方式平滑扩展。当前文档结构旨在让您在几分钟内上手——从身份验证、请求构建，到错误处理、分页和 webhook 集成的最佳实践模式。文档中提供了 Python、JavaScript、Java 和 C# 的代码片段，演示如何仅用一行代码触发完整比对，并配有沙盒环境，您可在浏览器中直接使用真实文件进行实验。阅读完本指南后，您将深入了解如何将可靠、高保真的电子表格比较嵌入任意工作流，降低人工审查时间，并为利益相关者提供透明、可审计的变更日志——所有这些都基于安全、快速且易于使用的 API。

主要特性

Comparison API 拥有丰富的功能集合，针对在不同平台之间对齐电子表格数据时常见的痛点提供了解决方案。首先，API 支持全面的文件格式列表：Apple Numbers（.numbers）、纯文本分隔文件（CSV、TSV）、传统 Excel（.xls）以及现代 Excel（.xlsx），无需预先转换工具，可直接将原始文件输入服务。差异引擎在单元格层面工作，检测数值、公式乃至字体样式、单元格填充、数据验证等格式属性的变化；每一处差异均通过可自定义的配色方案在生成的工作簿中清晰标注，方便非技术审阅者理解输出。针对大规模数据集，API 提供增量比较模式，仅比较自上一次基线后新增或修改的行，从而降低处理时间和网络带宽消耗。此外，您可以在获取可视化差异文件的同时请求结构化的 JSON 变更摘要，实现下游自动化，如触发告警、更新仪表盘或将变更写入版本控制系统。安全特性包括 OAuth 2.0 Bearer Token 鉴权、作用域化 API Key 以及可选的 IP 白名单，静态数据采用 AES‑256 加密。服务遵循 GDPR 与 CCPA 合规标准，让您在处理敏感个人或财务信息时更有信心。性能方面，API 经过低延迟设计；借助水平扩展和内存中差异算法，标准尺寸工作簿的比较通常在一秒以内完成，对超过 50 MB 的文件支持通过 webhook 的异步处理。最后，开发者体验是我们的核心关注点：完整的 OpenAPI 规范、自动生成的 SDK、详细的错误码以及实时速率限制响应头，使您能够轻松集成 API；沙盒控制台和丰富的示例库展示了批处理、CI/CD 流水线和无服务器函数等最佳实现方式。简而言之，Comparison API 提供快速、安全、面向开发者的电子表格差异功能，让您仅凭一次简单调用即可发现变化，无论数据的格式、大小或复杂度如何。

文档

参数

format: 受支持的输出文件格式。
UploadFileRequest.OperationId: 这是一个操作 ID
UploadFileRequest.Files: 这些是需要上传到我们在线服务的文件，您可以自行准备数据，但必须符合 HTML input 文件的标准。

使用端点

发送包含文件和访问令牌的请求比较 API

curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
服务将返回处理后文件的下载地址，在此示例中为：

{ "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'
您将收到文件，既可使用，也可直接转发至工作流的下一步。