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

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

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

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

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

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

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

Пример

Встройте QR-код на 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

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

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

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

Установка стилей через 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-кода или установили через API ссылок, сохраняются со ссылкой
3. 3
   Переопределения параметров запроса — переопределяйте отдельные стили для каждого запроса через параметры URL

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

Ограничения скорости

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

Ответ

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

Ошибочные ответы возвращают JSON:

{"error": "Rate limit exceeded"}

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

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