跳到主要内容
PDF4me API集成知识库扩展API 测试员博客

添加文字图章 PDF - 文字水印 API

PDF4me 添加文字图章 PDF 允许您添加可自定义的文本水印 PDF 用于授权和防止盗版的文档。 API 服务流程 PDF 文件并添加文本图章，可控制文本、位置、样式、旋转和外观。 API 接收 PDF 通过内容 REST API 利用电话 Base64 用于安全传输的编码。此解决方案非常适合文档品牌化、版权保护、状态指示器和企业级应用。 PDF 工作流程。

相关博客文章
目前尚无关于此功能的博客文章——敬请期待。
在此期间，您可以浏览 PDF4me 博客，查看适用于各平台的教程和工作流程。
访问博客 →

验证您的身份 API 要求​

要访问 PDF4me REST API每个请求都必须包含正确的身份验证凭据。身份验证可确保通信安全，并验证您作为授权用户的身份。 REST API。

Get your api Key

主要特点​

  • 灵活定位：以像素级精度控制水平和垂直对齐。
  • 定制造型：可选择各种字体、字号、颜色和文本效果（粗体、斜体、下划线）
  • 高级格式设置设置不透明度、旋转角度、边距和背景选项
  • 页面定位将印章贴到特定页面或整个文档上
  • 打印控制配置图章仅在打印或屏幕上显示
  • 专业成果创建水印以增强文档安全性和品牌形象
  • 异步处理支持对长时间运行的操作进行轮询的异步处理

REST API 端点​

这 PDF4me REST API 使用标准 HTTP 与资源交互的方法。所有文本戳记添加操作均通过单个端点执行：

  • 方法： 邮政
  • 终点： /api/v2/Stamp

支持的文本盖章功能​

这 API 提供对各种文本加盖和水印功能的全面支持：

文本自定义选项​

  • 字体选择您可以选择 Arial、Times New Roman、Helvetica 或 Courier New 字体。
  • 尺寸控制字体大小可在 8 到 72 之间调节
  • 颜色选项支持全光谱色彩，使用十六进制颜色代码（例如，#FF0000 代表红色）
  • 文字特效粗体、斜体和下划线格式选项
  • 自定义文本支持任何文本内容，包括符号和特殊字符

定位和布局​

  • 水平对齐：左侧、中间和右侧定位选项
  • 垂直对齐：顶部、中部和底部位置控制
  • 利润控制：基于毫米和像素的精确定位测量
  • 轮换支持文本旋转角度：0°（水平旋转），45°（对角旋转），90°（垂直旋转），-45°（反向对角旋转）
  • 灵活就业支持任何页面位置的精确测量

高级功能​

  • 不透明度控制可调节透明度（0-100），实现水印的微妙或突出效果
  • 后台模式：可选择将文本置于内容的后面或前面
  • 打印控制配置图章在视图和打印中显示，或仅打印。
  • 页面定位：应用于特定页面或整个文档
  • 文本拟合自动调整文本大小以适应页面边界（可选）

REST API 参数​

添加文本图章的完整参数列表 PDF REST API参数按类别组织，以便更好地理解和实施。

重要的： 标有星号 (*) 的参数为必填项，必须提供。 API 正常运作。

必需参数​

范围类型描述例子
文档名称*细绳输出 PDF 文件名带有 .pdf 扩展名output.pdf
文档内容*Base64PDF 文件内容以编码形式 Base64JVBERi...
页面*细绳页面选项：“全部”、“1”、“1,3,5”、“2-5”、“1,3,7-10”、“2-”all
文本*细绳要作为水印的文字CONFIDENTIAL - PDF4me Watermark
alignX*细绳水平对齐方式： 左边， 中心， 或者 正确的center
alignY*细绳垂直对齐： 顶部， 中间， 或者 底部middle

可选参数​

范围类型描述例子
marginXInMM细绳左侧边缘到水平边距的距离（毫米）50
marginYInMM细绳从顶部边缘算起的垂直边距（毫米）50
marginXInPx细绳左侧水平边距（像素）150
marginYInPx细绳顶部边缘的垂直边距（以像素为单位）150
不透明度细绳不透明度（0-100）：0=完全不可见，100=完全不透明30
字体名称细绳字体名称： 艾瑞尔， Times New Roman， Helvetica， 新快递Arial
字体大小整数字体大小（8-72）24
字体颜色细绳字体颜色（十六进制格式，例如红色为#FF0000）#FF0000
冰球布尔值将文本加粗（真）或常规（假）true
isItalics布尔值将文本设置为斜体（true）或正常（false）false
强调布尔值请在文本下方划线（正确）或不划线（错误）。false
旋转整数旋转角度： 0 （水平的）， 45 （对角线）， 90 （垂直的）， -45 （反向对角线）45
是背景布尔值将印章放置在背景（是）或前景（否）true
仅在印刷版中显示布尔值显示印章并打印（否）或仅打印（是）false
横布尔值横位（正确）或正常位（错误）false
fitTextOverPage布尔值文本适应整个页面（是）或使用指定大小（否）false
异步布尔值启用异步处理。 true， 这 API 返回 202 状态并提供轮询 URL 在 Location 标题true

输出​

这 PDF4me 添加文字图章 PDF REST API 根据处理模式的不同，会返回不同的响应。 API 返回 PDF 作为一个 Base64-编码字符串 JSON 格式不是二进制数据。

同步处理（默认）

什么时候 async 未设置或已设置为 false， 这 API 立即处理请求：

状态码： 200 OK

Content-Type： application/json

回复正文：

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg=="
}

回复字段：

  • 文档名称 （字符串）：输出 PDF 文件名
  • 文档内容 （字符串）： PDF 文件添加了文本戳记，编码为 Base64 细绳

使用方法：

  1. 提取 docContent 来自该领域的 JSON 回复
  2. 解码 Base64 获取二进制文件的字符串 PDF 数据
  3. 保存或处理 PDF 根据需要归档

例子 （JavaScript）：

const response = await fetch(url, options);
const data = await response.json();
const pdfBytes = atob(data.docContent); // Decode Base64
// Save or process pdfBytes

请求示例​

标题​

Content-Type: application/json
Authorization: Basic YOUR_BASE64_ENCODED_API_KEY

笔记：

  • 获得你的 API 钥匙 PDF4me 仪表板
  • 这 API 关键必须是 Base64 编码后以“Basic”为前缀 Authorization 标题
  • 例如：如果你的 API 关键是 abc123将其编码为 Base64 并使用 Authorization: Basic YWJjMTIz

有效载荷​

基本示例（仅必填字段）：

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle"
}

高级示例（包含所有可选字段）：

{
  "docName": "output.pdf",
  "docContent": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwovUGFnZXMgMiAwIFIKPj4KZW5kb2JqCjIgMCBvYmoKPDwKL1R5cGUgL1BhZ2VzCi9LaWRzIFszIDAgUl0KL0NvdW50IDEKPD4KZW5kb2JqCjMgMCBvYmoKPDwKL1R5cGUgL1BhZ2UKL1BhcmVudCAyIDAgUgovTWVkaWFCb3ggWzAgMCA2MTIgNzkyXQovUmVzb3VyY2VzIDw8Ci9Gb250IDw8Ci9GMSA0IDAgUgo+Pgo+PgovQ29udGVudHMgNSAwIFIKPj4KZW5kb2JqCjQgMCBvYmoKPDwKL1R5cGUgL0ZvbnQKL1N1YnR5cGUgL1R5cGUxCi9CYXNlRm9udCAvSGVsdmV0aWNhCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9MZW5ndGggNDQKPj4Kc3RyZWFtCkJUCi9GMSAxMiBUZgoxMDAgNzAwIFRkCihIZWxsbyBXb3JsZCkgVGoKRVQKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgNgowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMDkgMDAwMDAgbiAKMDAwMDAwMDA1NCAwMDAwMCBuIAowMDAwMDAwMTAxIDAwMDAwIG4gCjAwMDAwMDAxNzAgMDAwMDAgbiAKMDAwMDAwMDI0NCAwMDAwMCBuIAp0cmFpbGVyCjw8Ci9TaXplIDYKL1Jvb3QgMSAwIFIKPj4Kc3RhcnR4cmVmCjM0MQolJUVPRg==",
  "pages": "all",
  "text": "CONFIDENTIAL - PDF4me Watermark",
  "alignX": "center",
  "alignY": "middle",
  "marginXInMM": "50",
  "marginYInMM": "50",
  "marginXInPx": "150",
  "marginYInPx": "150",
  "opacity": "30",
  "fontName": "Arial",
  "fontSize": 24,
  "fontColor": "#FF0000",
  "isBold": true,
  "isItalics": false,
  "underline": false,
  "rotate": 45,
  "isBackground": true,
  "showOnlyInPrint": false,
  "transverse": false,
  "fitTextOverPage": false,
  "async": true
}

代码示例​

这 PDF4me 添加文字图章 PDF REST API 提供多种编程语言的代码示例。请选择最适合您开发环境的语言：

C# (CSharp) 示例

完全的 C# 实现向……添加文本戳记 PDF：

文本盖章功能​

自定义选项​

  • 字体控制多种字体系列，可自定义大小和颜色
  • 文字特效粗体、斜体和下划线格式选项
  • 色彩管理支持全光谱颜色，并带有十六进制代码
  • 文本内容支持任何文本，包括符号和特殊字符
  • 专业造型：高质量的文本渲染，清晰可见

定位和布局​

  • 对准控制精确的水平和垂直对齐选项
  • 边距设置：毫米级和像素级定位
  • 轮换支持：对角或倾斜水印的文本旋转
  • 灵活就业支持任何页面位置和方向
  • 页面定位：应用于特定页面或整个文档

高级功能​

  • 不透明度控制可调节透明度，实现水印的低调或醒目效果
  • 后台模式：可选择将文本置于内容的后面或前面
  • 打印控制配置图章仅在打印或屏幕上显示
  • 文本拟合自动调整文本大小以适应页面边界
  • 横向模式在整页上盖章

行业应用案例及应用​

法律及专业服务用例

  • 法律文件将法律免责声明和保密声明应用于法律文件
  • 合同盖章为合同和协议添加状态戳记
  • 保密声明在敏感法律文件上加盖保密印章
  • 合规印章在法律文件中添加监管合规声明

获取帮助​

Get Your API KeyAPI SamplesGetting Started