压缩

欢迎阅读 Compress 的官方文档 —— 这是一款轻量却强大的 API，只需一次直观的请求，即可将电子表格文件压缩至原始大小的几分之一。在当今数据驱动的世界，团队经常交换包含从简单列表到复杂财务模型的电子表格，而这些文件的庞大体积会快速成为隐藏成本——上传慢、存储费用升高、下游系统处理时间延长。Compress 通过提供云原生服务来解决这些痛点，它智能分析电子表格的内部结构，剔除不必要的负担，并将内容重新打包为优化的紧凑形式，同时不牺牲数据完整性或可读性。本页文档是您唯一可信的来源，指导您了解从身份验证、请求格式到错误处理和批处理最佳实践的全部内容。无论您是集成数据管道的资深后端工程师、希望提升文件上传用户体验的前端开发者，还是负责降低组织存储开支的 IT 经理，本指南都提供清晰的分步说明、多语言代码示例以及真实案例，帮助您在各种电子表格格式上实现最佳压缩效果。文档中还专门设有安全考虑章节——包括 TLS 加密、签名 JWT 令牌以及符合 GDPR 的数据处理——以及展示不同工作负载下典型延迟和吞吐量的性能基准。我们还提供了涵盖常见场景的丰富 FAQ、快速诊断问题的故障排查矩阵以及供您与其他使用 Compress 的开发者交流的社区论坛链接。阅读完本指南后，您将能够自信地配置环境、发送正确格式的 API 调用并解析响应负载，从而将压缩功能无缝嵌入现有工作流，立即看到存储成本和网络带宽的实质性节省。深入探索，挑选与您角色匹配的章节，让 Compress 为数据缩减的重任保驾护航，让您专注于构建更丰富、更灵活的应用。

主要特性

Compress API 的核心围绕一套丰富的功能，使电子表格压缩既轻松又可靠。首先，服务支持广泛的文件类型——包括 Apple Numbers、普通 CSV 和 TSV 文件，以及 Microsoft Excel 的 .xlsx 和 .xls 格式——因此您几乎可以发送任何遇到的电子表格，而无需预先转换。在内部，引擎执行多阶段优化：标准化文件的 XML 或二进制结构，消除重复样式，合并相同的单元格格式，删除不含数据的隐藏行列，并通过针对每种负载的无损压缩算法压缩嵌入的对象，如图片、图表和数据透视表。此外，API 会检测并剔除冗余的元数据、注释和版本信息，这些通常会导致文件体积膨胀却很少有实际作用。所有操作实时完成，对最大 50 MB 的文件可在毫秒级返回结果，并能通过平滑的限流和进度回调优雅扩展至更大的文档。安全性已内置——每个请求均通过 HTTPS 传输，服务在短暂的处理窗口后不会保留文件副本，确保符合严格的隐私法规。从开发者视角，API 设计尽可能无摩擦：一次对 `/compress` 端点的 POST 请求，文件以 multipart/form-data 形式上传，即可返回包含新文件下载 URL、原始及压缩后大小以及校验码的 JSON 响应。可选参数允许您微调压缩级别、保留特定工作表或白名单某些嵌入对象，以在下游应用中保持完整性。我们提供全面的 Python、Node.js、Java 和 Go SDK，每个 SDK 都暴露简洁的包装方法 `compressSpreadsheet(filePath, options)`，彻底屏蔽 HTTP 细节。详细的速率限制文档和批量上传端点使您能够每小时处理数千个文件而不压垮基础设施，内置的重试逻辑和指数回退机制确保管道在网络抖动时仍然稳健。总之，Compress API 提供快速、安全且开发者友好的解决方案，只需一次简单调用即可降低电子表格存储占用、加速文件传输并简化数据管理工作流。

文档

参数

AppRequest.CompressionLevel: 压缩级别，从 1 到 9（1 到 9）
UploadFileRequest.OperationId: 这是一个操作 ID
UploadFileRequest.Files: 这些是您需要上传到我们在线服务的文件，您可以自行准备数据，但必须符合 HTML input 文件的标准。

使用端点

发送包含文件和访问令牌的请求压缩 API

curl -X 'POST' \ 'https://api.sheetize.cloud/compress' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'AppRequest.CompressionLevel=2' \ -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'
您将收到文件，可以直接使用，也可以将其转发到工作流的下一步。