API 参考手册

xPdf API 用于从 JSON 请求生成高性能 PDF/A 文档。

接口地址

当前唯一 canonical 路由：

POST /api/v1/label

根据提供的 DocumentRequest 生成 PDF。

Headers

• Content-Type: application/json
• Authorization: Bearer <token>

Body

• 单个 DocumentRequest JSON 对象

主要能力

• 低层通用元素：文本、条码、线条、形状、图片、表格、stack
• 横向锚定定位：x_anchor 自动对齐元素
• 页面尺寸预设：a4、a6、letter、legal、label_100_100、label_100_150、label_4_6_in
• 图片格式：jpg、jpeg、png、webp、svg

核心概念

• 📋 JSON 数据结构：完整字段参考。
• Schema 参考：快速查看当前公开 JSON 结构。
• PDF Profiles：控制合规性级别。
• Metadata：管理文档属性与校验规则。