Clear

Clear Spreadsheet API 被设计为开发者在单次可靠调用中以编程方式清除电子表格文件中不需要的元素的终极解决方案。本页面作为您的综合指南，带您了解开始将服务集成到应用程序所需的一切。我们首先概述 API 的核心概念，解释服务如何解释不同的电子表格格式——从现代的 Office Open XML 文件（.xlsx）到旧版 Excel 二进制文件（.xls），以及 Apple Numbers、CSV、TSV 和其他表格表示。了解这些文件类型的细微差别至关重要，因为每种格式在不同结构中存储超链接、图像、图表和嵌入对象；Clear API 抽象这些复杂性，提供跨平台的统一接口。

主要功能

接下来，您将找到身份验证工作流的详细演练。平台使用行业标准的 API 密钥和可选的 OAuth 2.0 令牌，确保只有授权的客户端可以调用数据清理操作。安全最佳实践，如密钥轮换、IP 白名单以及通过 HTTPS 加密传输，在本节中深入讨论，以确保您能够保护自己的基础设施和终端用户的数据。完成身份验证后，“快速入门”部分提供了多语言（cURL、Python、JavaScript、.NET 和 Java）的快速代码示例，演示如何构建请求负载、附加电子表格文件并解析响应。示例展示了最简请求——仅包含您的 API 密钥、文件数据以及可选的要清除的元素类型列表——展示了 API “一次简单调用”的承诺。

文档

参数

format: 操作名称，包括：clearAll、clearHyperlinks、clearTables、clearPictures、clearShapes、clearComments、clearCharts、clearOleObjects、clearTextboxes、clearScenarios
AppRequest.OperationTables: 操作名称，包括：clearAll、clearHyperlinks、clearTables、clearPictures、clearShapes、clearComments、clearCharts、clearOleObjects、clearTextboxes、clearScenarios
UploadFileRequest.OperationId: 这是一个操作 ID
UploadFileRequest.Files: 这些是您需要上传到我们在线服务的文件，您可以以自己的方式准备数据，但必须遵循 HTML input file 的标准。

使用端点

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

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