添加文字水印 - Excel API
PDF4me 添加文字水印 允许您添加可自定义的文本水印 Excel 具有字体样式、透明度和定位控制的文档。 API 服务流程 Excel 文件并添加文本水印,用于安全标签、品牌标识和保密声明。 API 接收 Excel 通过文档内容 REST API 利用电话 Base64 用于安全传输的编码。此解决方案非常适合文档安全、品牌保护和状态指示工作流程。
相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间,您可以浏览 PDF4me 博客,查看适用于各平台的教程和工作流程。
访问博客 →
验证您的身份 API 要求
请包含您的 API 请求中用于身份验证的密钥 PDF4me REST API。
主要特点
- 自定义文字水印添加任意文字作为水印(例如,“机密”、“草稿”)
- 字体自定义控制字体系列、大小和颜色
- 透明度控制半透明或完全不透明的文本
- 定位选项控制放置和对齐
REST API 端点
- 方法: POST
- 终点:
office/ApiV2Excel/ExcelAddWatermark
REST API 参数
重要的: 标有星号 (*) 的参数为必填项。所有请求均使用 文档, 文档内容, 和 添加水印到 Excel 操作操作特定参数(watermarkText、fontFamily 等)是操作对象的属性。
必需参数(根级别)
| 范围 | 类型 | 描述 | 例子 |
|---|---|---|---|
| 文档* | Object | 文件参考 姓名 (Excel 文件名(.xlsx 或 .xls) | { "Name": "data.xlsx" } |
| 文档内容* | String (Base64) | Excel 文档内容编码 Base64 | UEsDBBQABgAIAAAA... |
| 添加水印到 Excel 操作* | Object | 操作配置。必须包含至少 水印文本 (字符串):要显示为水印的文本 | 请参见下方的有效载荷示例。 |
可选参数(位于 addWatermarkToExcelAction 函数内部)
| 范围 | 类型 | 描述 | 例子 |
|---|---|---|---|
| 字体系列 | String | 字体系列名称。默认值:Arial | Arial |
| 字体大小 | 数字 | 字体大小(磅)。默认值:72 | 48 |
| 字体颜色 | String | 十六进制颜色或颜色名称。默认值:黑色 | #808080 |
| 半透明 | Boolean | true = 50% 不透明度,false = 100%(默认值) | true |
| 文化名称 | String | 文本渲染的文化代码 | en-US |
输出
这 API 返回 Excel 以文件形式 Base64-编码字符串 JSON 格式 (文档,文件名,成功,错误消息)。
请求示例
标题
Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY
有效载荷(基本)
{
"document": { "Name": "data.xlsx" },
"docContent": "UEsDBBQABgAIAAAA...",
"addWatermarkToExcelAction": {
"watermarkText": "Confidential"
}
}