Шаблони
Рушій постачається з добіркою шаблонів: готових об’єктів 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.
Типові перевизначення
| Поле | Навіщо перевизначати |
|---|---|
content | URL або текст для кодування — перевизначається майже завжди |
outputWidth | Роздільна здатність для друку (1200, 2400, 4096) |
fileFormat | pdf або svg для друку, png для екрана |
logoUrl | Додайте свій логотип поверх будь-якого шаблону |
centerText | Додайте банер «ADMIT ONE» / «SCAN ME» |
ctaText | Підпис знизу |
Візуальна галерея
Усі шаблони, відрендерені поруч, — на сторінці /examples. Та сама галерея також включена до візуального довідника для перегляду офлайн.