PDF 水印

接口标识: pdfwatermark 价格: 0.05 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

PDF 水印接口给 PDF 文档叠加文字或图片水印，文字水印支持中文，字号 6~300 磅、透明度 0~1、旋转角度 -180~180 度均可调节，位置有平铺与九宫格共十种，还能限定作用页码（如 1,3-5）。单文件不超过 100MB、500 页，加密 PDF 返回明确错误。水印以独立图层叠加，不改动原文档文字，正文仍可选中复制，适合合同保密分发、报告版权标注与图纸会审等场景。

详细介绍

![PDF 水印接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_pdfwatermark__1794363368_d76132fb9cb6.png)

合同、报告、图纸对外流转，最怕被随意转发又无从追查。PDF 水印接口给文档压上文字或图片水印，让每一次流转都带着身份标记。

## 接口概述
面向文档对外分发、需要版权与保密标记的场景，传入一份 PDF（公网 URL、Base64 或平台文件 ID，不超过 100MB、500 页）并指定水印类型与内容，接口在指定页码范围的页面上叠加水印，同步返回处理后文件的下载地址与实际施加页数。文字水印支持中文，透明度、旋转角度、字号、摆放位置均可调节；图片水印可叠加标识图案。原文档文字内容不被改动，正文仍可正常选中复制，适合合同分发、报告发布、图纸会审等业务流程直接集成。

## 核心能力
1. **双类水印**：文字水印支持中文与常用字符，图片水印可叠加标识图案。
2. **十种位置**：平铺（tile）加上顶、中、底与左、中、右组合的九宫格位置共十种，平铺可满页铺满防止裁切。
3. **样式可调**：透明度 0~1（默认 0.3）、旋转角度 -180~180 度（默认 45）、文字字号 6~300 磅（默认 36）。
4. **页码定向**：可只作用于指定页（如 1,3-5），默认全文档；返回实际施加水印的页数供核对。
5. **明确报错**：加密 PDF、损坏文件、水印文字超长、页码写法无效都返回具体错误提示。

## 产品优势
1. **接入简单**：一次 POST 传入文件与水印参数即同步返回结果，无需安装插件或软件。
2. **正文无损**：水印以独立图层叠加，不改动原文档文字内容，正文仍可选中复制。
3. **防漏可溯**：平铺水印满页铺开，截图与转存页面都带着标记，便于追查泄漏来源。
4. **准确规范**：透明度、角度、字号、页码全部严格按参数执行，批量处理效果一致。
5. **降本增效**：替代在 PDF 软件里逐份手工盖章的流程，合同与图纸岗可批量作业。
6. **生态开放**：与平台 PDF 合并、拆分、压缩等接口共用同一套签名与响应结构，可组合使用。

## 效果展示
一句话理解：它就像给文件每一页盖上防伪章，章的内容、位置、深浅、角度由你定，而文件正文一个字都不少。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/contract.pdf | 要加水印的 PDF，公网 URL、Base64 或文件 ID，≤100MB、≤500 页 |
| watermark_type | text | 水印类型：text 文字水印，image 图片水印 |
| text | 机密文件 | 水印文字，text 类型必填，不超过 100 字符，支持中文 |
| position | tile | 摆放位置，tile 为满页平铺（默认），另有 center 与九宫格共九处 |
| pages | 1,3-5 | 作用页码，支持逗号与短横线写法，默认全部页面 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 加水印后 PDF 的下载地址 | `https://fujian.phpwc.com/pyapi/uploads/api/20261112/wm_20261112_102000.pdf` | `pdf_url`，可直接下载分发 |
| 实际施加水印的页数 | 4 | `pages_applied`，核对页码范围是否生效 |
| 文档总页数 | 32 | `total_pages`，原文档页数 |

API请求示例：

```text
POST /api/pdfwatermark
file=https://example.com/demo/contract.pdf&watermark_type=text&text=机密文件&position=tile&pages=1,3-5
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "pdf_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/wm_20261112_102000.pdf",
    "pages_applied": 4,
    "total_pages": 32
  },
  "request_id": "pdfwatermark-demo-001"
}
```

这次调用把「机密文件」四个字以默认 45 度角、0.3 透明度平铺在一份 32 页合同的第 1、3、4、5 页上；pages_applied 返回 4，说明页码范围准确生效，正文文字仍可正常选中复制。

## 应用场景
1. **合同分发**：外发合同压上保密标记，被转发也能追根溯源。
2. **报告发布**：研究与财报对外发布前加注版权水印，防止整篇搬运。
3. **图纸会审**：设计图、施工图叠加会审状态或单位标识，明确版本责任。
4. **内部资料**：培训课件、制度文件带上接收方身份标记，限制二次扩散。
5. **电子票证**：票据、凭证电子版加注专用标记，防止截图重复使用。

## 应用案例
一家律所的律师助理原先要给几十页的合同稿逐页手工加「保密」水印再外发，一份要十几分钟还偶有漏页；接入接口后，案件管理系统按文件密级自动压平铺水印，外发流程一步完成。

某财经资讯公司的运营负责人苦恼于研报发布当天就被截图转发；现在研报对外发布前统一叠加满页标识水印，转发行为明显收敛，出现外流也能按水印定位来源渠道。

一个家装设计平台要给发给客户的效果图压上「会审版」标记，原来靠设计师在图片软件里手工盖章、样式不统一；改用接口后位置、透明度、角度参数统一配置，批量出图效果完全一致。

常见问题

Q：水印会遮挡正文、影响复制吗？

A：水印以独立覆盖层叠加在页面上，原文档文字内容不被改动，正文仍可选中复制；通过 opacity（默认 0.3）调节深浅，可兼顾标记明显与阅读不受阻。

Q：position 支持哪些位置？

A：tile 满页平铺（默认），以及 top/center/bottom 与 left/center/right 组合的九宫格位置共十种；传入无法识别的取值时按 center 居中处理。

Q：能加中文水印吗？

A：支持。text 类型水印可写中文，长度不超过 100 字符，字号 6~300 磅可调，默认 36 磅。

Q：可以只给部分页加水印吗？

A：可以。pages 参数支持 1,3-5 这类逗号与短横线写法，默认作用于全部页面；响应中 pages_applied 返回实际施加水印的页数，便于核对。

PDF水印加水印文档保密防泄漏办公工具

接口地址： https://www.phpwc.cn/api/pdfwatermark

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	file	必填	-	PDF 文件，三形态：公网URL / data:application/pdf;base64 / file_id
`watermark_type`	string	必填	-	水印类型：text / image
`text`	string	选填	-	水印文字（text 时必填，≤100 字符）
`watermark_file`	file	选填	-	水印图片（image 时必填），三形态
`position`	string	选填	-	位置：center / tile / top_left / top_right / bottom_left / bottom_right 等，默认 tile
`opacity`	number	选填	-	透明度 0~1，默认 0.3
`rotate`	int	选填	-	旋转角度 -180~180，默认 45
`font_size`	int	选填	-	文字字号（磅），默认 36
`pages`	string	选填	-	作用页码，如 1,3-5，默认全部

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`pdf_url`	string	加水印后 PDF 下载地址
`pages_applied`	int	实际施加水印的页数
`total_pages`	int	PDF 总页数
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试