API V2

添加文本水印到PDF

API端点:Text Stamp

使用PDF4me Text Stamp API向PDF文档添加可定制的文本印章和水印。这个强大的工具允许您创建具有精确定位、自定义样式和高级格式化选项的专业水印。非常适合文档品牌化、版权保护和向PDF文件添加状态指示器。

主要功能:

  • 灵活定位:以像素级精度控制水平和垂直对齐
  • 自定义样式:从各种字体、大小、颜色和文本效果中选择(粗体、斜体、下划线)
  • 高级格式化:设置透明度、旋转、边距和背景选项
  • 页面定位:将印章应用到特定页面或整个文档
  • 打印控制:配置印章仅在打印或屏幕上显示
  • 专业结果:创建增强文档安全性和品牌化的水印

  • 方法: POST
  • 端点: /api/v2/Stamp

参数

文件名称String, Required

源文件名和正确的文件扩展名

文件内容Base64, Required

从上一步的 action 中映射源 PDF 文件内容

页数String, Required
  • 指定要处理的分页索引作为逗号分隔值或范围(例如,“0, 1, 2-” 或 “1, 2, 3-7”)。
  • 未指定时,默认配置将处理所有页面。输入必须为字符串格式。
文本String, Required

将在PDF文档上显示为印章或水印的文本内容。这可以是任何文本字符串,包括您希望显示为水印的单词、短语或句子。

示例:hello

垂直对齐String, Required

文本水印的垂直对齐。允许的值为

  • top - 页面顶部边缘
  • middle - 顶部和底部边缘之间相等的距离
  • bottom - 页面底部边缘
水平对齐string, Required

文本水印的水平对齐。允许的值为

  • left - 页面左侧边缘
  • center - 左侧和右侧边缘之间相等的距离
  • right - 页面右侧边缘
水平边距在毫米中String, Required

设置水平边距从页面的左侧边缘以毫米为单位
示例-100

垂直边距在毫米中string, Required

设置垂直边距从页面的顶部边缘以毫米为单位
示例-100

X 边距在像素中String, Required

文本水印从左原点在点(pt)中的边距
示例-40

Y 边距在像素中String, Required

文本水印从上原点在点(pt)中的边距
示例-1

透明度String, Required

设置水印的透明度。‘0’表示完全透明,‘100’表示完全不透明

字体名称String, Required

字体名称将显示,必须以字符串格式

字体大小Number, Required
Default: 12

水印中文本的字体大小

是粗体Boolean, Required
Default: No

设置文本为粗体
true
false

是斜体Boolean, Required
Default: No

设置文本为斜体
true
false

下划线Boolean, Required
Default: No

下划线水印文本

  • true
  • false
字体颜色String, Required

将采用字体颜色,必须以字符串格式
示例 - #000000

旋转integer, Required

将旋转,但以数字格式
示例 - 1 或 2

仅在打印时显示boolean, Required

您可以选择任何值
true
false

是背景boolean, Required

您可以选择任何值
true
false

横向boolean, Required

您可以选择任何值
true
false

适应页面上的文本boolean, Required

您可以选择任何值
true
false

输出

文件内容Binary

PDF4me 操作的输出文件内容

文件名String

PDF4me 操作的输出文件名

Header
Content-Type:application/json
Authorization: 请从链接复制密钥。

Payload

{
  "alignX": "right",
  "alignY": "middle",
  "docContent": "Please put PDF base64 content",
  "docName": "output.pdf",
  "pages": "all",
  "text": "enter_input_text",
  "fontName": "fontName",
  "fontSize": 12,
  "fontColor": "#000000",
  "isBold": false,
  "isItalics": false,
  "underline": false,
  "marginXInMM": "100",
  "marginYInMM": "100",
  "marginXInPx": "40",
  "marginYInPx": "1",
  "opacity": "70",
  "rotate": 1,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false
}

PDF4me API 代码示例

CSharp(C#)
Java
JavaScript
Python
Salesforce
n8n
Google Script
AWS Lambda