水印

欢迎阅读 Watermark API 文档——这是一种简化的解决方案，允许您通过一次开发者友好的请求，将自定义水印文本直接嵌入各种电子表格格式。无论您使用 Microsoft Excel 文件（.xlsx、.xls、.xlsm）、经典的 CSV 与 TSV 文件、Apple Numbers（.numbers），或其他众多支持的类型，我们的 API 都会为您处理繁重工作。只需上传源文件，提供所需的水印文本，即可让我们安全且高性能的服务返回已加水印、可供分发的文件。此功能非常适合添加品牌标志、版本标识、保密声明或任何强化文档控制与真实性的自定义标签。

主要特性

Watermark API 以速度和安全性为核心设计，可无缝集成到任何现有工作流中，无论您是构建基于云的 SaaS 平台、内部文件管理工具，还是自动化报告流水线。该端点支持 multipart 上传，验证文件完整性，并精确地添加水印，确保原始数据布局保持不变，同时添加的文本清晰可见。由于专为开发者构建，您将在本指南中看到清晰的错误信息、完整的响应码和详尽的示例请求。深入了解单次 API 调用如何保护您的电子表格、提升品牌一致性并简化文档生命周期管理。

文档

参数

AppRequest.WatermarkText: 如果您想使用 RGB 颜色填充此输入，请改用十六进制颜色。
AppRequest.WatermarkColorHex: 如果您想使用 RGB 颜色填充此输入，请改用十六进制颜色。
AppRequest.WatermarkTextRGB: 如果您想使用 RGB 颜色填充此输入，请改用十六进制颜色。
UploadFileRequest.OperationId: 这是操作 ID
UploadFileRequest.Files: 这些是您需要上传到我们线上服务的文件，您可以自行准备数据，但必须符合 HTML 输入文件的标准。

使用端点

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

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