文档转PDF

接口标识: word2pdf 价格: 0.01 元/次 VIP免费同步响应

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

接口简介

文档转PDF接口把Word文档（docx/doc，并兼容Excel、PPT、TXT等常见格式）转换为标准PDF文件，版式、字体、图片原样保留，并自动清理末尾空白页，建议单文件不超过20MB。转换完成即直接返回PDF文件与文件大小。适合合同电子归档、公文分发与报告交付等需要统一版式的场景。

详细介绍

![文档转PDF接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261109/apiops_word2pdf__1794166720_5bfb0ba9f47d.png)

把 Word 文档统一转成标准 PDF 再分发或归档，版式、字体、图片原样保留。本接口同步完成转换，一次调用直接返回 PDF 下载地址，无需轮询任务。

## 接口概述

文档转PDF接口面向文档分发、电子归档与签署前处理等业务场景：通过公网 URL、Base64（data: 开头）或文件 ID 上传 Word 文档（docx/doc），服务端转换引擎同步将其渲染为标准 PDF 文件，并自动清理转换后常见的末尾空白页，产物随即上传至文件存储，响应中直接返回 PDF 文件大小与下载地址，全程无需轮询任务状态。除 Word 外，接口同样兼容 Excel、PPT、TXT 等常见文档格式输入，统一输出 PDF。建议单文件不超过 20MB，单次转换设有 120 秒超时保护。

## 核心能力

1. **Word转PDF**：docx/doc 文档渲染为标准 PDF，版式、字体、图片保持一致。
2. **同步返回**：一次请求内完成转换并直接返回下载地址，集成方式最简单。
3. **空白页清理**：自动检测并移除转换产生的末尾空白页，产物更干净。
4. **多格式兼容**：Excel、PPT、TXT 等常见文档同样支持输入，统一输出 PDF。

## 产品优势

- **接入简单**：POST 请求、JSON 返回，仅 `file` 一个业务参数，结果即取即用。
- **效果保真**：服务端专业文档引擎渲染，输出与桌面办公软件导出效果一致。
- **稳定可靠**：服务端并发控制、负载均匀；转换失败返回明确错误提示，单次转换 120 秒超时保护。
- **响应迅速**：同步等待、即转即得，免去提交与轮询两步流程。
- **存储省心**：产物自动上传至文件存储并登记台账，下载地址可直接分发给终端用户。

## 效果展示

一句话理解：它就像给文档进了一次「印刷厂」——出来的是在任何设备上都长一个样、不易被随手改动的标准 PDF。

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

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/report.docx | 要转换的 Word 文档：公网 URL / data: 开头的 Base64 / fileid_ 开头的文件 ID |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| PDF文件大小 | 268435 | `file_size`，单位字节 |
| PDF下载地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261107/report.pdf | `output_dourl`，临时下载地址，请及时下载；产物转存失败时接口直接返回错误提示 |

API请求示例：

```
POST /api/v1/word2pdf
file=https://example.com/demo/report.docx
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "file_size": 268435,
    "output_dourl": "https://fujian.phpwc.com/pyapi/uploads/api/20261107/report.pdf"
  }
}
```

同步接口一次调用即出结果：code=0 时 output_dourl 就是 PDF 下载地址，可直接落库或分发给终端用户下载；文件下载失败、格式不支持等情况会返回对应错误提示。

## 应用场景

- **文档分发**：报告、通知统一转 PDF 后下发，杜绝版式错乱
- **电子归档**：业务文档以标准 PDF 归档，满足档案管理要求
- **签署前处理**：合同文档转 PDF 后进入电子签章、盖章流程
- **票据生成**：系统生成的 Word 账单自动转 PDF 供用户下载
- **打印服务**：为打印场景提供标准化 PDF 文件，保证输出一致

## 应用案例

- **SaaS 办公系统**：用户点击「导出 PDF」后，后台调用接口同步完成转换并返回下载地址，浏览器直接下载，用户端无需安装任何办公软件。
- **合同管理平台**：合同定稿前自动把 Word 稿转为 PDF 归档，同时保留可编辑原稿，归档件与草稿双轨存储，版本追溯一目了然。

常见问题

Q：这个接口能做什么？

A：上传 Word 文档（docx/doc），同步转换为标准 PDF，响应直接返回 PDF 下载地址（output_dourl）与文件大小（file_size），无需轮询任务。

Q：支持哪些输入格式？

A：以 Word（docx/doc）为主，同时兼容 Excel（xls/xlsx）、PPT（ppt/pptx）、TXT 等常见文档格式，统一输出 PDF。

Q：是同步还是异步接口？

A：同步接口，一次请求内完成转换并返回结果；单次转换设 120 秒超时保护，建议单文件不超过 20MB，超大文档可拆分后提交。

Q：转换结果存放在哪里？

A：产物自动上传至文件存储，响应中的 output_dourl 即下载地址；该地址为临时地址，请及时下载转存。

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

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	string	必填	-	传入word（docx/doc）文件，公网URL / Base64(data:开头) / 文件ID(fileid_开头)

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

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`file_size`	int	转换后 PDF 文件大小（字节）
`output_dourl`	string	转换完成后 PDF 下载地址
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

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

调用失败：

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

请先登录后使用在线测试