Modelli

Il motore include una selezione curata di modelli: oggetti QrConfig predefiniti che richiami tramite id. Usali quando vuoi un risultato visivo sicuramente valido senza dover creare nulla a mano.

Elencare i modelli

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

Filtrare per categoria

GET /api/qr/templates?category=luxury

La struttura della risposta è identica a quella della chiamata senza filtro, ma include solo le corrispondenze. Le categorie non distinguono tra maiuscole e minuscole e corrispondono al campo category di ogni modello. Consulta l'elenco aggiornato nella scheda "Modelli" di /examples.

Generare da un modello

POST /api/qr/templates/{templateId}

Il corpo è un sottoinsieme di QrConfig: tutto ciò che imposti sovrascrive i valori predefiniti del modello. La maggior parte dei chiamanti sovrascrive solo content, outputWidth e fileFormat.

Sovrascritture comuni

Campo	Perché sovrascriverlo
`content`	L'URL o il testo da codificare: quasi sempre sovrascritto
`outputWidth`	Risoluzione di stampa (1200, 2400, 4096)
`fileFormat`	`pdf` o `svg` per la stampa, `png` per lo schermo
`logoUrl`	Aggiungi il tuo logo sopra qualsiasi modello
`centerText`	Aggiungi un banner "ADMIT ONE" / "SCAN ME"
`ctaText`	Didascalia sotto

Galleria visiva

Tutti i modelli generati uno accanto all'altro si trovano su /examples: la stessa galleria è inclusa anche nel riferimento visivo per la consultazione offline.