PDF 生成模板编辑器
开源可视化 PDF 生成引擎，支持自定义模板，并提供面向开发者的 API，灵活构建文档生成流程。
ComPDF 与 Zapier 集成指南
当 Zapier 的 ComPDF 应用提供所需动作时，直接使用该应用；否则可通过 Webhooks by Zapier 调用 ComPDF Cloud 并使用任意您想要的功能。处理文档后，将结果传递给 Zap 中的下一款应用。
开始前准备： 一个 Zapier 账号、ComPDF API Key，以及一个不含敏感信息的测试文件。
创建连接并运行第一个 Zap
按照以下步骤完成您的自动化工作流创建，更完整的操作演示请参阅 使用 ComPDF 在 Zapier 中处理 PDF。
- 创建 ComPDF 账号： 前往 ComPDF 登录 / 注册，然后打开 API Keys 页面，获取免费 API Key。
- 创建并保存 API Key： 为密钥设置易识别的名称并立即复制完整值。将其放在私有 Zapier 连接或 Secret 中，不要放入共享 Zap 或截图。
- 创建 Zap： 选择一个能提供文件或可访问文件 URL 的触发器。如果 URL 需要浏览器会话才能访问，请先下载文件，或使用支持 multipart 的请求。
- 选择 ComPDF 功能： 如果 ComPDF Zapier 应用列出了所需动作，直接使用该动作；否则选择 Webhooks by Zapier，设置 Method 为
POST，URL 为https://api-hub.compdf.com/api/v2/files/upload。 - 映射字段并测试： 添加
Authorization: Bearer YOUR_API_KEY，映射file或url，将mode设为VisualExtract或LayoutExtract，并可选添加metadata。 - 验证后再继续： 确认响应体中的
code: 200，保存data.batchId和data.taskIds，然后添加结果动作，或设置受控的 Delay + 任务查询。
Webhooks 最小配置
| 字段 | 示例值 |
|---|---|
| Method | POST |
| URL | https://api-hub.compdf.com/api/v2/files/upload |
| Header | Authorization: Bearer YOUR_API_KEY |
url | 触发器提供的文件 URL |
mode | VisualExtract |
metadata | {"source":"zapier"} |
常见工作流和直接可用的工作流
您可以从零开始创建您的工作流，但 ComPDF 已经为您提前创建了基础的流程，可作为您工作流的核心步骤，选择并开始创建您的自动化工作流！更多工作流请查看ComPDF Zapier 集成目录。
Google Drive → ComPDF：将更新的 PDF 转为 DOCX
监听 Drive 文件，并将有更新的文件转换为 DOCX，后续步骤您可以根据业务需求进行自定义，比如保存在Google Drive、通过邮件发送给客户、或共享给企业其他同事等。
Email by Zapier → ComPDF：将收到的附件转换为 PDF
以邮件附件作为输入，继续处理生成的 PDF。
Google Drive → ComPDF AI：提取结构化数据
从更新的 Drive 文档中提取字段，并映射到业务应用。
API 请求参考
当当前 ComPDF 动作列表未提供所需动作时，可通过 Webhooks by Zapier 使用通用 HTTP 请求：
http
POST https://api-hub.compdf.com/api/v2/files/upload
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data
url={{Trigger File URL}}
mode=VisualExtract
metadata={"source":"zapier","record_id":"{{Record ID}}"}检查响应体中的 code: 200，然后保存 data.batchId 和 data.taskIds。
故障排查
| 现象 | 检查方法 |
|---|---|
401 / unauthorized | 确认 API Key 有效，且 Authorization 值以 Bearer 开头。 |
| ComPDF 无法获取文件 | 确认触发器提供的 URL 无需浏览器会话即可访问，且尚未过期。 |
| 请求成功但结果尚未就绪 | 检查响应体 code，保留任务 ID，并添加 Delay + 查询或 Catch Hook。 |
| 出现重复记录 | 在 metadata 中保留来源 ID，并确保后续动作可以识别重复记录。 |
常见问题
应该使用 ComPDF 应用还是 Webhooks by Zapier？
所需动作已提供时使用 ComPDF 应用；当前动作列表未暴露所需端点或参数时使用 Webhooks by Zapier。
如何处理异步任务？
保存任务 ID，然后使用受控的 Delay 和查询，或通过 Catch Hook 接收已验证的 ComPDF Webhook。
可以上传私有文件吗？
可以使用支持文件的 multipart 请求处理私有来源。使用 URL 时，该地址必须能被 ComPDF 访问，并在读取期间保持有效。