PPT 转 PDF API

将 PowerPoint 演示文稿转换为 PDF。

功能说明

ComPDF Self-hosted 提供同步文件流响应。该功能可以通过 ComPDF 请求地址调用，也可以直接调用转档接口。

调用方式

项目	值
认证	x-api-key: your_api_key_here
请求地址	POST http://localhost:8080/api/v1/process/pptx/pdf
请求类型	multipart/form-data
成功响应	PDF 文件流

请求参数

参数名	类型	说明	是否必填
file	File	源文件，建议扩展名：.ppt,.pptx。	是
options	String	JSON 字符串，包含下方功能参数。	否
password	String	源文件打开密码，适用于受密码保护的 PDF。	否

Options 参数

以下字段放入 options JSON 字符串中。ComPDF Self-hosted 会解析 JSON，并在转发给转换引擎前做少量规范化。

参数名	类型	作用
sourceType	String 或 Integer	非 PDF 转 PDF 的源类型标记。ComPDF Web 会传 1。
outputFileName	String	可选输出文件名。传入后会作为首选下载文件名。

请求示例

curl -X POST "http://localhost:8080/api/v1/process/pptx/pdf" \
  -H "x-api-key: your_api_key_here" \
  -F "[email protected]" \
  -F 'options={"sourceType":"1"}'

响应

成功时返回转换后的文件流，响应头包含 Content-Type 和 Content-Disposition。如果转换失败，ComPDF Self-hosted 会返回接口错误码中定义的统一错误响应，其中包含 type、code、errorCode、message 和 traceId。