AGY PDF Service MVP

文档转 PDF 的 HTTP API：上传 Word 直接出 PDF（保真直转），或给一个网页 URL 排版成 PDF。按次计费，预付费额度。

接入方式

所有请求带请求头 X-API-Key: <你的密钥>。密钥向管理员申请，泄露可随时吊销换发。

端点

方法 / 路径	说明	价格
`POST /v1/doc2pdf`	multipart 上传 `.doc`/`.docx`，返回 PDF 字节流。表单参数 `fix_layout`（默认 1）：开启竖排货号合并、主标题居中等版式修正。	0.02 元 / 次
`POST /v1/html2pdf`	JSON 指定网页 URL，wkhtmltopdf 排版为 PDF。URL 域名必须在白名单内（接入时申请报备）。	0.02 元 / 次
`GET /v1/balance`	查询余额与累计用量。	免费
`GET /v1/usage?days=7`	近期调用流水。	免费

html2pdf 请求体

{
  "url":             "https://example.com/report/123",   // 必填，域名需在白名单
  "header_url":      "https://example.com/hdr.html",     // 可选，页眉
  "footer_url":      "https://example.com/ftr.html",     // 可选，页脚
  "margins":         {"top":20,"bottom":38.5,"left":17.3,"right":18},  // mm，可选
  "header_spacing":  5.4,      // mm，可选
  "footer_spacing":  6,
  "page_size":       "A4",
  "timeout_s":       90        // 10~180
}

示例

# Word 转 PDF
curl -X POST https://pdf.agy.top/v1/doc2pdf \
  -H "X-API-Key: YOUR_KEY" \
  -F "file=@报价单.doc" -F "fix_layout=1" \
  -o 报价单.pdf

# 网页转 PDF
curl -X POST https://pdf.agy.top/v1/html2pdf \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/page"}' \
  -o page.pdf

# 余额
curl -H "X-API-Key: YOUR_KEY" https://pdf.agy.top/v1/balance

错误码

HTTP	含义
401	API Key 缺失 / 无效 / 已吊销
402	余额不足，请联系管理员充值
403	目标 URL 域名不在白名单
413	文件超过 25MB
422	转换失败（文件损坏 / 页面加载失败），不扣费
429	触发限流（默认 60 次/分钟）

隐私承诺：转换完成后立即删除，服务器上不留存任何客户文件。仅记录调用流水（时间、端点、耗时、字节数），不记录文件内容。

计费规则

预付费额度，转换成功才扣费，失败不扣。当前 0.02 元/次；月免费额度与阶梯价商务洽谈。