generate

Генерує QR-код з явної конфігурації. Це основний ендпоінт рендерингу — і інтерфейс редактора, і ендпоінт ШІ зрештою звертаються саме до нього.

Запит

Content-Type: application/json або multipart/form-data (для завантаження двійкових файлів логотипа / фону).

Структура тіла: об’єкт QrConfig.

Мінімальний приклад:

Завантаження multipart (файл логотипа)

curl -X POST https://api.qr-branding.com/api/qr/generate \
  -H "X-RapidAPI-Proxy-Secret: <secret>" \
  -F 'config={"content":"https://yourbrand.com","logoSizePercent":18,"eccLevel":"H"}' \
  -F "logoFile=@./brand-mark.png"

Поле config — це рядок у кодуванні JSON. logoFile і backgroundFile — двійкові частини (PNG / JPG / GIF / BMP / WebP до 10 MB).

Відповідь (режим base64 — за замовчуванням)

{
  "success": true,
  "qrBase64": "iVBORw0KGgoAAAANSUhEUgAA…",
  "format": "png",
  "contentType": "image/png",
  "sizeBytes": 38291
}

Відповідь (двійковий режим)

{ "responseType": "binary" }

Повертає сирі байти файлу з відповідним Content-Type і Content-Disposition: attachment; filename="qrcode.png".

Перевірка

Рушій виконує повний конвеєр гарантії сканування. Типові причини відхилення:

Код	Значення	Як виправити
`CONTENT_TOO_LONG`	Закодований рядок > 4296 символів	Скоротіть / скористайтеся сервісом скорочення URL
`LOW_CONTRAST`	Контраст переднього плану й фону < 4:1	Виберіть темніший передній план або світліший фон
`LOGO_TOO_LARGE`	`logoSizePercent` > 25 при ECC нижче H	Підвищте до H або зменште логотип
`INVALID_HEX`	Рядок кольору не у форматі `#RGB`, `#RRGGBB`, `#RRGGBBAA`	Виправте колір
`INVALID_LLM_MODEL`	Лише в ендпоінті ШІ	Див. Режим ШІ

Див. також

Довідник QrConfig — усі параметри, що приймаються
POST /api/qr/ai/generate — той самий рушій, конфігурацію створює ШІ