Plantillas

El motor incluye una selección de plantillas: objetos QrConfig predefinidos que llamas por su id. Úsalas cuando quieras un resultado visual que funcione seguro sin tener que diseñar nada a mano.

Listar plantillas

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"
    },
    { "...": "..." }
  ]
}

Filtrar por categoría

GET /api/qr/templates?category=luxury

La respuesta tiene la misma forma que la llamada sin filtro, pero solo incluye las coincidencias. Las categorías no distinguen mayúsculas de minúsculas y se comparan con el campo category de cada plantilla. Consulta la lista actual en la pestaña «Templates» de /examples.

Generar a partir de una plantilla

POST /api/qr/templates/{templateId}

El cuerpo es un subconjunto de QrConfig: todo lo que indiques sustituye a los valores por defecto de la plantilla. La mayoría solo cambia content, outputWidth y fileFormat.

Ajustes habituales

Campo	Por qué cambiarlo
`content`	La URL o el texto que se codifica; casi siempre se cambia
`outputWidth`	Resolución de impresión (1200, 2400, 4096)
`fileFormat`	`pdf` o `svg` para imprimir, `png` para pantalla
`logoUrl`	Pon tu logo encima de cualquier plantilla
`centerText`	Añade una banda «ADMIT ONE» / «SCAN ME»
`ctaText`	Texto al pie

Galería visual

Todas las plantillas renderizadas una junto a otra están en /examples; la misma galería se incluye también en la referencia visual para consultarla sin conexión.