用途:PDForge 是 PDFNoodle 提供的 PDF 生成 API,用于根据预建模板或原始 HTML 生成 PDF 文档,适合发票、报告等文档生成场景。
主要能力:支持模板同步生成(/v1/pdf/sync)、模板异步生成(/v1/pdf/async,配合 webhook 回调)、HTML 转 PDF(/v1/html-to-pdf/sync);可通过 convertToImage 返回 PNG;支持 metadata(title、author、subject、keywords)、hasCover(首页隐藏页眉页脚)、debug、pdfParams 等参数。
使用方式:需设置 PDFORGE_API_KEY,Base URL 为 https://api.pdfnoodle.com/v1。模板请求需提供 templateId 与 data;HTML 请求需提供 html。示例:curl -s -X POST "https://api.pdfnoodle.com/v1/pdf/sync" --header "Authorization: Bearer $PDFORGE_API_KEY" --header "Content-Type: application/json" -d @/tmp/pdforge_request.json。同步返回 signedUrl 与 executionTime,异步返回 requestId,完成后 webhook 收到 signedUrl。
限制与排查:signedUrl 为临时链接,1 小时后过期,需及时下载;HTML 转 PDF 建议内联 CSS。请求失败可运行 zero doctor check-connector --env-name PDFORGE_API_KEY 或 zero doctor check-connector --url https://api.pdfnoodle.com/v1/pdf/sync --method POST 排查。模板需先在控制台创建。