API для генерации QR-кодов

Через QR API код создаётся не в веб-форме, а автоматическим запросом: скрипт или бэкенд отправляет параметры, сервис возвращает готовый файл или ссылку на него. Это основа для автоматизации — от массовой печати билетов до подключения генератора к 1С, CRM или движку интернет-магазина.

Как устроен запрос

Типовой вызов — HTTP GET или POST на конечную точку генерации. В параметрах передают содержимое (data), размер картинки в пикселях (size), формат файла (format: png или svg) и уровень коррекции ошибок (ecc — L, M, Q или H). Ответ — бинарный файл изображения либо JSON со ссылкой на него, в зависимости от реализации сервиса.

Пример обобщённого запроса:

/api/qr?data=ORDER-48213&size=400&format=svg&ecc=M

Для длинных данных, например URL с UTM-метками, разумно поднять уровень коррекции и размер — иначе плотный код плохо читается при мелкой печати на этикетке.

Статические и динамические QR через API

Статический вызов зашивает данные прямо в код: что передали в data, то и закодировано навсегда, изменить контент нельзя — только сгенерировать код заново. Для динамического QR-кода через API код хранит короткую ссылку на редирект, а конечный адрес меняется на стороне сервера без переиздания картинки. Так подключают серии купонов и этикеток с трекингом переходов: печать остаётся прежней, а поведение кода перенастраивается в любой момент.

Когда нужен API вместо ручного генератора

Ручной генератор годится для одного кода: открыли форму, ввели данные, скачали файл. API нужен там, где кодов много и они собираются на лету — тысячи билетов на мероприятие, отдельный купон под каждого покупателя, этикетка со штучным номером партии из 1С, персональная ссылка под заказ в интернет-магазине. Всё это подключается одним HTTP-запросом на каждую единицу — без ручной работы менеджера и без риска опечатки при массовом вводе.

Частые вопросы

Какие параметры обычно передают в запросе к QR API?

Минимальный набор — data (что зашить в код), size (размер картинки в пикселях) и format (png или svg). Часто добавляют ecc — уровень коррекции ошибок от L до H: чем выше, тем устойчивее код к загрязнению и повреждению, но тем плотнее рисунок. Некоторые сервисы принимают ещё цвет, отступы и логотип по центру.

Чем ответ API отличается от файла из ручного генератора?

По содержимому картинки — ничем, тот же PNG или SVG. Разница в способе получения: ручной генератор требует открыть форму и скачать файл вручную, а API отдаёт результат прямо в код приложения по HTTP-запросу. Это позволяет генерировать сотни и тысячи кодов без участия человека — например, при оформлении заказов.

Можно ли через API создать динамический QR-код?

Да, но логика отличается от статического. API создаёт код с короткой ссылкой на редирект, а куда она ведёт — настраивается отдельным запросом на стороне сервиса и может меняться сколько угодно раз. Сама картинка при этом не меняется, поэтому уже напечатанный тираж этикеток остаётся рабочим при смене адреса назначения.

PNG или SVG выбрать при запросе к QR API?

PNG подходит для экранов и большинства случаев печати в фиксированном размере — растр не увеличивают без потери качества. SVG — векторный формат, он масштабируется без потери резкости, поэтому его берут для баннеров, наружной рекламы и макетов, где размер финальной печати заранее неизвестен или сильно варьируется.

Нужна ли авторизация для работы с QR API?

Обычно да — доступ к API привязывают к аккаунту и выдают ключ или токен, который передаётся в заголовке запроса или как отдельный параметр. Это позволяет считать лимиты по тарифу, отделять данные одного клиента от другого и отключать доступ при необходимости без блокировки уже выпущенных кодов.