Vorlagen

Die Engine bringt eine kuratierte Auswahl an Vorlagen mit: vorgefertigte QrConfig-Objekte, die du per ID aufrufst. Nutze sie, wenn du ein garantiert gutes Ergebnis willst und nichts von Hand gestalten musst.

Vorlagen auflisten

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

Nach Kategorie filtern

GET /api/qr/templates?category=luxury

Die Antwort hat dieselbe Struktur wie der ungefilterte Aufruf, enthält aber nur Treffer. Kategorien unterscheiden nicht zwischen Groß- und Kleinschreibung und werden mit dem Feld category jeder Vorlage abgeglichen. Die aktuelle Liste siehst du unter /examples im Tab „Vorlagen“.

Aus einer Vorlage generieren

POST /api/qr/templates/{templateId}

Der Body ist eine Teilmenge von QrConfig – alles, was du setzt, überschreibt die Standardwerte der Vorlage. Die meisten Aufrufer überschreiben nur content, outputWidth und fileFormat.

Häufige Überschreibungen

Feld	Warum du es überschreiben würdest
`content`	Die zu codierende URL bzw. der Text – wird fast immer überschrieben
`outputWidth`	Druckauflösung (1200, 2400, 4096)
`fileFormat`	`pdf` oder `svg` für Druck, `png` für Bildschirm
`logoUrl`	Dein Logo auf eine beliebige Vorlage setzen
`centerText`	Ein Banner wie „ADMIT ONE“ / „SCAN ME“ hinzufügen
`ctaText`	Bildunterschrift darunter

Visuelle Galerie

Alle Vorlagen nebeneinander gerendert findest du unter /examples – dieselbe Galerie ist auch in der visuellen Referenz zur Offline-Ansicht enthalten.