API 参考

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

---

📍 接口端点

端点	认证	说明
POST /api/v1/label	Internal Token	系统间调用
POST /api/v2/label	无	测试/开发
POST /api/v3/label	Bearer Token	推荐 - 面向用户

---

📋 核心文档

文档	说明
📋 JSON 数据结构	完整字段参考 - 所有参数详解
🔐 认证机制	Bearer Token 与缓存策略
Schema 定义	快速参考
PDF Profiles	合规等级配置
元数据与校验	文档属性规则

---

📚 详细参考

文档	语言
完整参考 (Claude)	中文
完整参考 (Gemini)	English

---

🔧 请求格式

Headers:

Content-Type: application/json
Authorization: Bearer <token>  (仅 V3)

Body: LabelRequest[] 数组

[
  {
    "pdf_params": { "width": 100, "height": 60 },
    "items": [{ "1d_params": [...], "text_elements": [...] }]
  }
]

---

⚠️ 错误码

错误码	触发条件
E001	字体缺失字符
E002	无效 pdf_profile
E003	PDF/UA-1 缺失 metadata_title