WebQR API
генерация брендированных QR с вашего сервера
Один HTTP-запрос — SVG в ответе. Те же настройки design, что в конструкторе WebQR. Без хранения кодов на нашей стороне.
Ключевые возможности
API генерации
Генерируйте статические QR-коды через API: отправьте строку и объект дизайна — получите SVG за доли секунды.
Дизайн и брендирование
Применяйте цвета бренда, формы модулей, рамки и логотипы — всё через объект design.
Без хранения на WebQR
API без состояния на стороне WebQR: нет серверной библиотеки ваших QR. Храните SVG и метаданные в своём приложении.
Почему разработчики выбирают API WebQR
Stateless REST, полный контроль design и предсказуемые лимиты по тарифу.
SVG за миллисекунды
POST /v1/generate принимает строку data и объект design — в ответе готовый SVG в data.qr_code для сохранения у себя.
Design как в конструкторе
Цвета бренда, формы модулей, глазки, рамки и логотип — те же поля, что вы настраиваете визуально в кабинете.
Градиенты и стили модулей
Градиентная заливка, скругления, прозрачный фон — всё через JSON без отдельного рендера на вашей стороне.
Stateless — без библиотеки на WebQR
API не хранит ваши payload и не выдаёт постоянные id. SVG и метаданные — только в вашей инфраструктуре.
Прозрачная месячная квота
Успешная генерация учитывается в included_limit; GET /v1/usage показывает счётчики без расхода лимита.
Ключи, IP и подпись
X-API-Key из кабинета, whitelist IP и опциональная HMAC-подпись для production.
Включённые генерации в месяц
Успешный POST /v1/generate с SVG в ответе = +1 к used_count. Квота сбрасывается в начале календарного месяца.
Starter
200
генераций / месяц
Premium
5 000
генераций / месяц
Business
25 000
генераций / месяц
Нужен оверэйдж сверх квоты — подключите биллинг API в кабинете. Подробнее на странице Тарифы
Три шага до первого QR
Без SDK — обычный HTTPS и JSON с любого бэкенда.
-
1
Создайте API-ключ
В кабинете WebQR: один или несколько ключей, ограничение по IP, опциональная подпись.
-
2
Отправьте POST /v1/generate
Заголовок X-API-Key и JSON с полями data и design. Ответ — SVG и блок usage.
-
3
Сохраните SVG у себя
Файл, CDN, печать, email — WebQR не хранит результат; id и версии ведёте вы.
Ключ и безопасность
Не встраивайте API‑ключи в сайты и приложения — вызывайте API только с сервера.
Ограничьте доступ списком разрешённых IP и при необходимости включите HMAC‑подпись запросов (см. документацию в кабинете).
- Секрет — только на сервере; клиентам отдавайте свой HTTPS, а не ключ.
- Ограничьте ключ списком IP ваших серверов (или фиксированного egress CDN).
- По желанию включите обязательную HMAC‑подпись в настройках ключа.
Аналитика использования API
Посмотрите демо: бесплатные и платные генерации, графики по дням и разбивка по API-ключам — без регистрации.
Частые вопросы
Включённых успешных генераций за календарный месяц по тарифам: 200 — Starter (бесплатный), 5000 — Premium, 25000 — Business. Если нужно больше — напишите нам.
Да. Вы можете создавать QR через API или вручную в основном конструкторе на главной странице.
Да. Starter уже включает Static QR API: 200 успешных генераций за календарный месяц (включённая квота); Premium — 5000, Business — 25000; квота обновляется в начале каждого месяца. Отдельной подписки «только за API» нет; при необходимости возможен платный оверэйдж по настройкам биллинга.
В JSON приходит готовый SVG (поле data.qr_code), те же content и design, что вы отправили, плюс блок usage для учёта квоты. Это stateless-сценарий: один вызов API сам по себе не попадает в вашу «библиотеку» WebQR как отдельная запись и не даёт постоянный id в ответе — файл и любые связки храните у себя на бэкенде или в вашем хранилище. То, что вы сами сохраните в конструкторе или кабинете WebQR, живёт отдельно по обычным правилам проектов.