Перейти до вмісту

Шаблони

Рушій постачається з добіркою шаблонів: готових об’єктів 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.

Типові перевизначення

ПолеНавіщо перевизначати
contentURL або текст для кодування — перевизначається майже завжди
outputWidthРоздільна здатність для друку (1200, 2400, 4096)
fileFormatpdf або svg для друку, png для екрана
logoUrlДодайте свій логотип поверх будь-якого шаблону
centerTextДодайте банер «ADMIT ONE» / «SCAN ME»
ctaTextПідпис знизу

Візуальна галерея

Усі шаблони, відрендерені поруч, — на сторінці /examples. Та сама галерея також включена до візуального довідника для перегляду офлайн.