PDF 合并

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

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

接口简介

PDF 合并接口把 2~20 个 PDF 文件按指定顺序或文件名拼装成一份完整文档，合并后页码连续、内容完整。单个文件不超过 50MB、合计不超过 200MB；加密或损坏的 PDF 会返回明确错误提示，不会静默产出坏文件。返回合并后的文件与总页数、文件数统计，适合合同附件汇总、标书分册拼装、零散报告归档与电子票据整理等场景。

详细介绍

![PDF 合并接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_pdfmerge__1794363364_886464805045.png)

合同、标书、报告常常散落成多个 PDF，手工合并要装软件、还容易搞错页序。PDF 合并接口一次调用完成拼装，直接给出页码连续的完整文件。

## 接口概述
面向需要把多份 PDF 文档汇总归档的办公场景，传入 2~20 个 PDF 文件（公网 URL、Base64 或平台文件 ID 均可），接口按传入顺序或文件名逐个解析、拼装为单个 PDF，同步返回合并后文件的下载地址与总页数、文件数统计。全程无需安装软件、无需人工干预，可直接嵌入合同管理、档案数字化、票据处理等业务系统，实现文档从收集到交付的全自动汇总。

## 核心能力
1. **批量合并**：一次合并 2~20 个 PDF，单个不超过 50MB、合计不超过 200MB，满足合同、报告、票据类日常汇总需求。
2. **两种排序**：默认按传入顺序合并；指定 name 可按文件名排序，适合按章节编号命名的分册拼装。
3. **页数统计**：返回合并后的总页数与实际合并的文件数，便于核对与登记。
4. **明确报错**：加密 PDF、损坏文件、体积超限都直接返回具体错误，不会静默产出坏文件。

## 产品优势
1. **接入简单**：一次 POST 传入文件数组即同步拿到结果，无需配置回调、无需等待任务。
2. **响应迅速**：同步处理、一次返回，业务系统无需再建任务查询逻辑。
3. **稳定可靠**：文件解析与拼装全部在平台内完成，不依赖外部服务，无上游抖动风险。
4. **准确规范**：页序严格按传入顺序或文件名执行，页码连续，不漏页、不重页。
5. **降本增效**：替代在桌面 PDF 软件里手工拼接再另存的流程，档案与合同岗可批量处理。
6. **生态开放**：与平台 PDF 拆分、水印、压缩等接口共用同一套签名与响应结构，接入一次处处复用。

## 效果展示
一句话理解：它就像一台文档装订机，你把多份 PDF 按顺序递进去，它吐出一份装订好、页码连续的厚文件。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| files | ["https://example.com/demo/chapter1.pdf","https://example.com/demo/chapter2.pdf"] | 要合并的 PDF 数组，2~20 个，每项为公网 URL、Base64 或文件 ID，单个 ≤50MB、合计 ≤200MB |
| sort | order | 合并顺序：order 按传入顺序（默认），name 按文件名排序 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 合并后 PDF 的下载地址 | `https://fujian.phpwc.com/pyapi/uploads/api/20261112/merged_20261112_101530.pdf` | `pdf_url`，可直接下载或转发到自己的系统 |
| 合并后总页数 | 128 | `total_pages`，方便与原文件页数核对 |
| 实际合并的文件数 | 2 | `merged_count`，确认本次合并了几份 PDF |

API请求示例：

```text
POST /api/pdfmerge
files=["https://example.com/demo/chapter1.pdf","https://example.com/demo/chapter2.pdf"]&sort=order
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "pdf_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261112/merged_20261112_101530.pdf",
    "total_pages": 128,
    "merged_count": 2
  },
  "request_id": "pdfmerge-demo-20261112"
}
```

响应同步给出合并文件地址与页数统计；任何一个 PDF 加载失败、已加密或超体积，接口都会返回具体错误提示，不会产出拼了一半的坏文件。

## 应用场景
1. **合同归档**：合同正文、附件、审批页自动合并为一份文件统一存档。
2. **标书制作**：商务标、技术标分册编写完成后按文件名顺序一键拼装。
3. **报告汇总**：各部门月报合并成完整报告，便于向上呈报。
4. **电子票据**：发票与清单散落在多封邮件，合并后统一报销存档。
5. **电子书装订**：按章节生成的 PDF 逐个合并为整本成品书。

## 应用案例
一家建筑设计院的资料员每次投标都要把几十个分册文件逐个下载、用软件拼接再上传，一次要半小时还偶有页序错误；接入接口后，系统在截标前按文件名自动调用合并，一次完成装订归档。

某报销系统的产品经理需要把员工上传的发票 PDF 与清单合并成单一凭证文件，原方案依赖前端插件、手机端体验差；改用接口后合并放在服务端完成，手机与电脑的体验一致了。

一个电子书制作团队按章节导出独立 PDF，交付前要拼成整本；现在出版流程按章节号文件名自动合并，并用返回的总页数核对书稿页数，交付差错明显减少。

常见问题

Q：最多能合并多少个文件？体积有什么限制？

A：一次支持 2~20 个 PDF，单个文件不超过 50MB、合计不超过 200MB；不足 2 个或超过 20 个都会返回参数错误。

Q：合并顺序怎么确定？

A：默认按 files 数组的传入顺序合并；传 sort=name 则按文件名排序后合并，适合按章节编号命名的分册文件。

Q：传入加密 PDF 会怎样？

A：接口会尝试以空密码解析，无法解密的加密文件返回明确错误并指明该文件无法合并，不会产出拼了一半的坏文件。

PDF合并文件拼接文档汇总办公工具 PDF工具

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`files`	array	必填	-	PDF 文件数组，2~20 个，每项为三形态（公网URL/data:pdf;base64/file_id），单个 ≤50MB、合计 ≤200MB
`sort`	string	选填	-	排序：order（按传入顺序，默认）/ name（按文件名）

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

响应参数

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

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试