文档处理 · 同步接口

PDF合并API接入指南

PDF合并API把多个PDF文件按上传顺序合并为一个完整PDF：以files字段一次性上传至少2个文件（每个最大10MB），接口同步返回外网可访问的结果文件URL。适合合同归档、报告拼装、扫描件整理等批量文档场景，配合在线PDF工具可免注册直接体验。

2026年8月20日更新 · 参数与计费已按当前生产接口核对

在线调试接口免费在线工具

接口速览

以下信息来自轻语API开放平台生产环境接口元数据，可直接用于技术选型评估。

接口地址	POST /data/api/document/pdf/merge
计费	按调用计费（详见控制台）
频率限制	60次/分钟
超时时间	60秒
鉴权方式	apikey（注册后获取）
内容类型	multipart/form-data

请求参数

参数名	必填	类型	说明
`apikey`	必填	`string`	用户的apikey，身份凭证
`files`	必填	`file[]`	要合并的PDF文件，至少2个，每个最大10MB，按上传顺序拼接

响应示例

成功响应（HTTP 200）

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "fileUrl": "https://file.luanqing.net/5555api/document/merged_xxx.pdf",
    "fileName": "merged_xxx.pdf"
  }
}

调用示例

cURL 示例

curl -X POST 'https://5555api.com/data/api/document/pdf/merge' \
  -F 'apikey=YOUR_APIKEY' \
  -F 'files=@contract-part1.pdf' \
  -F 'files=@contract-part2.pdf' \
  -F 'files=@appendix.pdf'

JavaScript 示例

const fd = new FormData();
fd.append('apikey', 'YOUR_APIKEY');
[...fileInput.files].forEach(f => fd.append('files', f)); // 至少2个PDF

const resp = await fetch('https://5555api.com/data/api/document/pdf/merge', {
  method: 'POST',
  body: fd
});
const result = await resp.json();
if (result.code === 200) {
  window.open(result.data.fileUrl); // 打开合并后的PDF
}

Python 示例

import requests

files = [
    ('files', open('part1.pdf', 'rb')),
    ('files', open('part2.pdf', 'rb')),
    ('files', open('appendix.pdf', 'rb'))
]
resp = requests.post(
    'https://5555api.com/data/api/document/pdf/merge',
    data={'apikey': 'YOUR_APIKEY'},
    files=files
)
result = resp.json()
if result['code'] == 200:
    print('合并结果:', result['data']['fileUrl'])

示例中的 YOUR_APIKEY 请替换为你在轻语API控制台获取的apikey；不要在公开页面或客户端代码中暴露正式API Key。

应用场景

合同与标书归档

盖章页、正文、附件多个PDF按顺序合并成一份完整文件，直接归档或发送。

报告自动化拼装

系统分章节生成的PDF自动合并成完整年报、检测报告，返回的URL直接挂到业务系统。

扫描件整理

按页扫描产生的多个小PDF批量合并，每个最大10MB，避免拆分上传的来回操作。

常见问题

PDF合并API怎么调用？

POST https://5555api.com/data/api/document/pdf/merge，FormData携带apikey和至少2个PDF文件（files字段），返回合并后PDF的下载地址。

合并顺序是怎么确定的？

按files的上传顺序拼接。前端按用户选择的顺序append，后端按列表顺序依次append即可控制最终页序。

单次最多合并几个PDF？

接口要求至少2个文件，单个文件最大10MB。文件数量以总体积不超过限制为准，建议单次合并控制在个位数文件以保证处理速度。

返回的fileUrl能保存多久？

返回的是外网可直接访问的PDF地址。重要文件建议业务系统及时转存到自己的存储，避免依赖临时文件地址。

加密或损坏的PDF能合并吗？

带密码保护的PDF无法解析会被拒绝；损坏的PDF可能合并失败，建议先做文件有效性校验再提交。

还有其他PDF处理接口吗？

轻语API同时提供PDF拆分、加水印、转Word、转图片、图片转PDF、Markdown转PDF等文档处理接口，可在平台接口目录中查看。