ComPDF 与 Make 集成指南

使用 Make 与 ComPDF 开始与任意 APP 串接并处理文件。完整支持的功能参考 ComPDF Cloud。

开始前准备： 一个 Make 账号、ComPDF API Key，以及一个不含敏感信息的测试文件。

创建连接并运行第一个 Scenario

本指南未提供可验证的公开 ComPDF Blueprint。请使用 Make 工作区中可用的模块搭建 Scenario。

1. 创建 ComPDF 账号： 前往 ComPDF 登录 / 注册，然后打开 API Keys 页面。每月免费 200+ 次 API 调用。
2. 创建并保存 API Key： 立即复制完整密钥，并保存在安全的 Make 连接或受限变量中。不要将密钥放进共享 Scenario 或公开 Blueprint。
3. 创建 Scenario： 添加来源触发器，例如 Google Drive Watch Files，再添加来源应用对应的 Download File 模块。
4. 添加 ComPDF： 使用当前可用的 ComPDF 模块，或添加 HTTP > Make a request。设置 Method 为 POST，URL 为 https://api-hub.compdf.com/api/v2/files/upload。
5. 配置请求体： 添加 Authorization: Bearer YOUR_API_KEY。使用 HTTP 时选择 Multipart/form-data，添加名为 file 的 File 字段，再添加 mode 和可选的 metadata 文本字段。
6. 运行一次并继续： 启用响应解析，验证 HTTP 状态及响应体 code: 200，保存任务 ID，再通过 Custom Webhook 或受控的状态查询等待处理完成。

HTTP · Make a request 配置示例

字段	示例值
Method	POST
URL	https://api-hub.compdf.com/api/v2/files/upload
Body type	Multipart/form-data
file	File：{{download.data}}
mode	Text：LayoutExtract
metadata	Text：{"source":"make"}
Response parsing	Enabled

Guides & Scenario 示例

在 Make 平台使用 ComPDF Integrations，您可以与任意 Make 中的 APP 进行连接并处理对应 APP 中的文档。请查看详细指南了解如何通过 Make 平台开始搭建您的自动化工作流程。

Google Drive → ComPDF：提取发票字段

监听文件夹、下载发票、提取字段，并将异常交给审核。

Watch → Download → Extract → ERP / Review

Email / Dropbox → ComPDF：转换或合并文件

接收源文档，执行转换或合并，再保存处理结果。

Source → File → ComPDF → Storage

Form → ComPDF：处理提交材料

处理支持性文档，筛选不完整案例，并在需要审核时通知负责人。

Form → Extract → Filter → Queue

API 请求参考

需要使用通用 HTTP 请求时，可参考以下 multipart 请求。让 Make 自动生成 multipart boundary，不要手动写入：

POST https://api-hub.compdf.com/api/v2/files/upload
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

file={{download.data}}
mode=LayoutExtract
metadata={"source":"make","scenario_id":"invoice-intake"}

继续后续流程前，确认响应中的 code: 200。

故障排查

现象	检查方法
Multipart 请求被拒绝	选择 Multipart/form-data，并让 Make 生成 boundary；不要手动固定 boundary。
收到空文件	检查下载模块的 bundle，并将实际文件数据和文件名映射到 File 字段。
响应字段缺失	启用响应解析，并运行一次 HTTP 模块，让 Make 读取响应结构。
Scenario 过早继续	保存任务 ID，并在更新目标系统前使用 Custom Webhook 或受控的任务状态查询。

常见问题

需要导入 ComPDF Blueprint 吗？

不需要。本指南采用模块搭建方式。请在 Make 中自行建立 Scenario，并检查当前工作区中的 ComPDF 模块是否可用。

需要手动设置 Content-Type 吗？

选择 Multipart/form-data 并让 Make 生成 boundary。Authorization header 单独添加。

如何处理异步任务？

使用 Custom Webhook 或受控的任务查询。写入最终记录前，核对任务 ID 和原始业务标识。