Демо для разработчиков

Static QR API — живой пример

Один запрос POST /v1/generate с заголовком X-API-Key → в ответе SVG (data.qr_code). Эта страница ходит к вашему API через прокси на этом же домене, чтобы обойти CORS в браузере. Ключ и черновик JSON можно сохранить только локально в вашем браузере.

  1. 1 Подключение и ключ
  2. 2 Данные и design (JSON)
  3. 3 Запрос и превью
  4. 4 Сохранение SVG в списке

Подключение

Укажите базовый URL API (без пути /v1/...) и ключ из кабинета WebQR. Значения по умолчанию можно задать в .env рядом с router.php — см. env.example.

Хранение ключа в браузере удобно для демо, но на общих ПК лучше не включать сохранение.

Тело запроса

API принимает JSON: обязательное поле data (строка до 4000 символов) и необязательный объект design с настройками внешнего вида (цвета, стиль модулей, глазки, скругления и т.д.).

Примеры: URL https://webqr.io, текст, WIFI:S:MyNet;T:WPA;P:secret;; и любая строка, которую должен отсканировать телефон.

Пресеты design:
Подсказка по полям design
  • size — сторона в px (100–2048).
  • color, backgroundColor и др. — цвета #RRGGBB.
  • styleType, eyeType, eyeInnerType — идентификаторы стиля (как в конструкторе WebQR).
  • roundedCorners, cornerRadius — скругление.
  • showColorGradient, fromColor, toColor, styleColorGradient — градиент заливки модулей.
  • frameType, title, textUnderQr — опциональная рамка и подписи.

Полный список правил совпадает с валидацией API на стороне WebQR (см. проект, сервис static QR).

Инспектор запроса и ответа

Ниже — точное тело, которое уходит на API (через прокси), последний ответ и готовая команда curl для копирования в терминал. В ответе SVG в JSON сокращён для читаемости — включите «полный JSON», если нужно увидеть всё. 

— Сформируется после «Отправить» или при изменении полей (черновик).

Сохранённые генерации

Кнопка «Сохранить SVG в список» записывает последний успешный результат в localStorage этого браузера вместе с data и design. Это не облако WebQR — только ваше устройство.