API генератора QR-кодов

Генерируйте изображения QR-кодов, добавляя .qr.png к любой короткой ссылке Linkly. Аутентификация или API-ключ не требуются.

Изображение возвращается в формате PNG со всеми сохранёнными стилями QR-кода, включая пользовательские цвета, паттерны точек, стили глаз и логотипы.

Базовое использование

Добавьте .qr.png к любой короткой ссылке Linkly:

https://linkly.link/2W6Z9.qr.png

Это возвращает PNG-изображение QR-кода размером 1024x1024. Если вы настроили цвета, стиль или логотип QR-кода в Linkly, эти стили применяются автоматически.

Пример

Встраивание QR-кода в HTML-страницу:

html <img src="https://linkly.link/2W6Z9.qr.png" alt="QR Code" />

Или используйте его в шаблоне письма, PDF или в любой системе, поддерживающей URL изображений.

Параметры стиля

Передавайте параметры запроса для переопределения сохранённых стилей QR-кода или изменения размера изображения:

https://linkly.link/2W6Z9.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Примечание: hex-цвета должны быть URL-encoded — используйте %23 вместо # (например, %23ff0000 для #ff0000).

Размеры логотипа автоматически масштабируются в соответствии с запрошенным размером изображения.

quietZone добавляет пустой отступ вокруг всего QR-кода, заполненный цветом bgColor. Это полезно при печати QR-кодов на тёмном фоне — без него позиционирующие глаза располагаются вплотную к краю и могут не сканироваться надёжно. Например, quietZone=50&bgColor=%23ffffff добавляет белую границу шириной 50 пикселей.

Установка стилей через Link API

Вы можете сохранять стили QR-кода в ссылку при её создании или обновлении через API сокращения ссылок. Передайте JSON-объект qr_styles с любым из перечисленных выше ключей стилей:

  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
} ```

После сохранения эти стили автоматически применяются при каждом запросе изображения `.qr.png` — параметры запроса не нужны.

Как применяются стили

Стили QR-кода разрешаются в следующем порядке:

1. 1
   Стили по умолчанию — чёрный передний план на прозрачном фоне, квадратные модули, 1024px
2. 2
   Сохранённые стили — любые настройки, сделанные в редакторе QR-кода или заданные через Link API, хранятся вместе со ссылкой
3. 3
   Переопределения через параметры запроса — переопределяйте отдельные стили для каждого запроса через URL-параметры

При наличии логотипа Linkly автоматически использует высокую коррекцию ошибок (уровень H), чтобы QR-код оставался сканируемым.

Ограничения частоты запросов

Конечная точка ограничена 5 запросами в секунду на IP-адрес. Изображения кэшируются на 5 минут, поэтому повторные запросы одного и того же QR-кода обслуживаются быстро.

Ответ

Успешный запрос возвращает статус 200 с Content-Type: image/png и данными PNG-изображения в теле ответа.

Ответы об ошибках возвращаются в формате JSON:

json {"error": "Rate limit exceeded"}

Связанные ресурсы

• Создать QR-коды — как создавать и настраивать QR-коды в Linkly
• Добавить логотип к QR-коду — создавайте брендированные QR-коды с логотипом вашей компании
• SVG QR-коды — скачивайте QR-коды в масштабируемом векторном формате
• API сокращения ссылок — создавайте и управляйте ссылками программно
• API аналитики — экспортируйте данные о кликах и отчёты о трафике