模板

引擎内置了一套精选模板：可按 ID 调用的预置 QrConfig 对象。如果你想要有保障的好看效果，又不需要手工打磨细节，就用它们。

列出模板

GET /api/qr/templates

{
  "success": true,
  "count": 118,
  "templates": [
    {
      "id": "champagne-onyx",
      "name": "Champagne on Onyx",
      "category": "luxury",
      "tags": ["dark", "monogram", "premium"],
      "preview": "https://api.qr-branding.com/api/qr/templates/champagne-onyx/preview"
    },
    { "...": "..." }
  ]
}

按分类筛选

GET /api/qr/templates?category=luxury

响应结构与不筛选时相同，只是仅包含匹配的结果。分类不区分大小写，与每个模板的 category 字段进行匹配。实时列表请查看 /examples 的“模板”标签页。

基于模板生成

POST /api/qr/templates/{templateId}

请求体是 QrConfig 的子集，你设置的任何字段都会覆盖模板的默认值。大多数调用方只覆盖 content、outputWidth 和 fileFormat。

常用覆盖项

可视化图库

所有模板并排渲染的效果见 /examples。同一个图库也打包进了可视化参考资料中，方便离线查看。