API QR-кодов - программная генерация QR-кодов
Встройте генерацию QR-кодов в приложение, SaaS-панель, мобильный backend, e-commerce процесс или стек маркетинговой автоматизации с REST API QR-Build. Отправляйте JSON-параметры, получайте PNG, SVG или base64 JSON и управляйте динамическими QR-направлениями без собственной реализации генератора.
Веб-сайт
Что такое API QR-кодов?
REST API — это HTTP-интерфейс со стандартными правилами запросов и ответов. В API QR-кодов endpoint — это конкретный URL, который вызывает приложение, например POST /v1/qr, а тело запроса содержит параметры QR: type, data, format, size, color и признак статического или динамического кода.
API выбирают, когда создание QR должно происходить внутри продуктового процесса: пользователь SaaS нажимает create, e-commerce каталог импортирует 5 000 SKU, мобильное приложение запрашивает код для обмена, или CRM-кампания создает отслеживаемые QR-материалы после события.
QR-Build поддерживает статические и динамические QR-коды. Статический код хранит конечное назначение прямо в изображении. Динамический код хранит redirect layer QR-Build, что позволяет менять назначение и смотреть аналитику после печати или распространения.
Как создать QR-код через QR-Build API?
QR-Build API рассчитан на серверную интеграцию. Если сначала нужен ручной сценарий, посмотрите, как создать QR-код в веб-интерфейсе, а затем используйте API, когда генерация должна запускаться из кода.
- 1 Выполните аутентификацию API-ключом. API-ключ — уникальная строка учетных данных, которая идентифицирует аккаунт QR-Build и авторизует каждый запрос.
- 2 Отправьте POST-запрос. Передайте JSON-параметры на endpoint генерации, включая тип QR, данные назначения, формат изображения и размер.
- 3 Получите QR-код. Ответ может вернуть PNG URL, SVG-разметку или base64 JSON payload в зависимости от запрошенного формата вывода.
- 4 Обновляйте динамические назначения при необходимости. Для динамических QR-кодов отправьте PATCH-запрос, чтобы изменить redirect destination без повторной генерации напечатанного QR-изображения.
- 5 Получайте аналитику, если QR динамический. Используйте analytics GET endpoint, чтобы забрать число сканирований, временные метки, географию и разбивку устройств в свою панель.
Пример POST-запроса
curl -X POST https://api.qr-build.com/v1/qr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"url","data":"https://example.com","format":"png","size":300}'Пример JSON-ответа
{
"id": "qr_8x4m2p",
"type": "url",
"format": "png",
"static": true,
"imageUrl": "https://cdn.qr-build.com/qr/qr_8x4m2p.png",
"createdAt": "2026-07-01T12:00:00Z"
}Какие форматы запросов и ответов поддерживает API?
Выбирайте формат ответа по месту отображения QR-кода, способу хранения и потребности downstream-систем в метаданных. Мы оцениваем форматы по DPI, размеру файла, поддержке браузерами и количеству HTTP round-trips.
Поддерживаемые форматы вывода
| Формат | Лучше всего для | Примечания |
|---|---|---|
| PNG | Печать, email, быстрое встраивание | Растровое изображение с фиксированным разрешением; для печати и упаковки запрашивайте больший размер. |
| SVG | Веб-приложения, масштабируемый UI, high-DPI дисплеи | Векторный формат остается четким при любом размере и подходит для адаптивных панелей. |
| Base64 | Inline HTML, PDF и процессы без файлов | Встраивает данные изображения в JSON или HTML без отдельного публичного URL изображения. |
| JSON | Программная обработка и хранение метаданных | Возвращает идентификаторы, данные изображения, назначение, формат и метаданные создания в одном ответе. |
Типы QR, поддерживаемые через API
По состоянию на 2026 год QR-Build API поддерживает 12 типов QR-кодов. Для более широкого обзора смотрите типы QR-кодов.
URL / link
Generate a QR code that opens a web page, landing page, support article, or app deep link.
WiFi
Encode network name, password, and security type so users can join a network after scanning.
vCard
Create contact QR codes with name, phone, email, company, job title, and website fields.
Point users to manuals, menus, brochures, compliance documents, or downloadable files.
Open a prefilled email with recipient, subject, and body fields.
Phone
Create scan-to-call QR codes for service desks, sales teams, and support labels.
Menu
Generate QR codes for restaurant menus, seasonal menu pages, and table placements.
Coupon
Create promotional QR codes for discounts, redemption pages, and campaign offers.
Crypto
Encode wallet addresses and payment metadata for supported cryptocurrency flows.
PayPal
Create payment QR codes that route to PayPal payment or donation destinations.
Calendar
Generate QR codes for event details, appointment reminders, and calendar invites.
Bulk
Create many QR codes from one batch request for catalogs, tickets, labels, and print runs.
Статические и динамические QR-коды через API
Выбор между статическим и динамическим QR — архитектурное решение. Используйте статические QR для фиксированных назначений, а динамические — когда кампании, продукты, этикетки или печатные материалы могут требовать правок или аналитики. Узнайте, чем статические и динамические QR-коды отличаются вне контекста API.
| Функция | Статический QR через API | Динамический QR через API |
|---|---|---|
| Назначение редактируется | Нет | Да |
| Аналитика сканирований | Нет | Да |
| URL в payload QR | Прямой конечный URL | Redirect layer QR-Build |
| Лучше всего для | Фиксированные материалы и постоянные ссылки | Кампании, продукты, упаковка и печатные материалы |
| Метод обновления назначения | Сгенерировать и напечатать заново | PATCH на management endpoint |
| Подходящий план | Тестирование на бесплатном уровне и фиксированное использование | Платные планы для аналитики и управления большими объемами |
Методологическое примечание: сравнение основано на поведении QR-Build API. Перед production-развертыванием всегда проверяйте доступность функций, rate limits и требования тарифа у своего QR-провайдера.
Сценарии интеграции API QR-кодов
Вот интеграционные паттерны, где API QR-Build полезнее ручного генератора.
E-commerce - Per-product QR codes at scale
Generate QR codes for product pages, packaging inserts, warranty cards, receipts, and shelf labels as SKUs are created or updated. Bulk generation keeps QR output aligned with catalog data.
SaaS products - Embedded QR generation
Add QR creation to a dashboard without building a QR rendering engine, redirect layer, or analytics storage from scratch. Your product sends the request; QR-Build handles the QR output.
Marketing automation - Campaign QR codes
Trigger QR generation from CRM, CDP, email, or campaign events. Dynamic QR codes let marketers update destinations mid-campaign while keeping printed assets live.
Mobile apps - Lightweight API calls
iOS and Android apps can request QR images through a server-side backend, then render an image URL or base64 payload in the app without exposing the API key.
Document and label printing
Create QR codes for logistics labels, inventory sheets, compliance packets, and operational documents. This pattern is especially useful when labels are generated from database records.
See QR codes for inventory managementAPI или ручной QR-генератор - когда что использовать?
Генератор QR-кодов QR-Build подходит для ручного создания. API нужен, когда генерация QR должна запускаться из продуктового workflow, backend job или automation pipeline.
| Сценарий | Использовать API | Использовать ручной генератор |
|---|---|---|
| One-off QR code for a flyer | Лучший выбор | |
| Generate 500+ QR codes for products | Лучший выбор | |
| QR codes embedded in a SaaS dashboard | Лучший выбор | |
| Campaign QR with an updatable destination | Лучший выбор | |
| Quick WiFi QR code for an office | Лучший выбор | |
| Real-time QR generation after user action | Лучший выбор |
API Key Authentication and Security
An API key is account-scoped and should be sent as a Bearer token in the Authorization header. Do not place API keys in query strings, browser JavaScript, mobile app binaries, public repositories, or analytics logs.
Run QR generation calls from your backend, serverless function, or trusted integration service. Client-side apps should call your server, and your server should call QR-Build. This prevents users from extracting the key and consuming your quota.
Rate limiting is a server-enforced cap on requests per time window, and plan details can change as products evolve. Review the current pricing page before production rollout instead of relying on copied limits in a blog post or implementation ticket.
QR-Build enforces HTTPS for API traffic. For dynamic QR codes, the QR image stores the redirect layer, not the final destination URL; destination changes happen through authenticated management requests.
Code Examples for the QR Code API
Methodology note: the examples below use the same API surface our own QR-Build web generator uses - no separate API tier. Replace placeholder keys and IDs with values from your account before testing.
Generate a URL QR Code (curl)
curl -X POST https://api.qr-build.com/v1/qr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"type":"url","data":"https://example.com","format":"png","size":300}'Generate a URL QR Code (JavaScript / Node.js)
const response = await fetch("https://api.qr-build.com/v1/qr", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.QR_BUILD_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
type: "url",
data: "https://example.com",
format: "svg",
size: 300
})
});
if (!response.ok) {
throw new Error(`QR generation failed: ${response.status}`);
}
const qr = await response.json();
console.log(qr.imageUrl);Update a Dynamic QR Destination
curl -X PATCH https://api.qr-build.com/v1/qr/qr_8x4m2p \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"destination":"https://example.com/new-campaign"}'How Does Bulk QR Code Generation Work via API?
Bulk generation is designed for product catalogs, event tickets, packaging labels, inventory tags, print runs, and agency workflows where many QR codes share a common pattern but differ by destination or metadata.
A typical bulk request includes an array of rows, each with type, data, format, size, and optional label metadata. The response can return a job ID for asynchronous processing, a ZIP file URL, or a JSON array of generated QR assets depending on batch size and account settings.
For high-volume jobs, treat rate limits as part of the integration design. Queue batches, retry safely after rate-limit responses, and avoid regenerating static QR images when a cached asset is still valid.
Can You Access Scan Analytics via API?
Scan analytics are collected when a dynamic QR code routes through the QR-Build redirect layer. Static QR codes do not pass through a redirect layer, so they cannot provide the same scan analytics model.
Analytics API access is useful when your product needs to show QR performance inside its own dashboard, combine scan data with CRM records, or export campaign events to a warehouse. For dashboard-based reporting, see the scan analytics dashboard guide.
A webhook is an HTTP callback that can notify your server when a scan event occurs. Webhooks are useful when scan data should trigger real-time downstream actions, such as lead scoring, inventory lookup, or campaign attribution.
Common QR Code API Integration Mistakes
Hardcoding API keys in client-side code
We've seen teams expose keys in browser JavaScript and mobile binaries. Always make API calls from a trusted server-side environment.
Using static QR when dynamic QR is needed
If the destination may change after print, use a dynamic QR code with a redirect layer. Static QR codes require regeneration and reprinting.
Not handling API errors or rate limits
Handle non-2xx responses, retry only when safe, and display clear failure states in your product instead of silently dropping QR generation.
Generating QR images at too low a resolution
Small PNG output can look fine on screen but fail on packaging or signage. Use SVG for scalable output or request larger PNG dimensions for print.
Ignoring quiet zone requirements
The quiet zone is the blank margin around the QR code. Cropping it can make an otherwise valid QR code difficult or impossible to scan.
Best Practices for QR Code API Integration
Use dynamic QR for changeable destinations
Campaigns, product pages, support documents, and printed labels often change after distribution. Dynamic QR codes prevent costly reprints.
Cache generated static QR images
If a static QR code's payload is permanent, store the generated asset and reuse it instead of creating the same code repeatedly.
Match format to channel
Use SVG for responsive web interfaces, PNG for simple print and email workflows, and JSON or base64 when downstream systems need embedded image data.
Validate destination URLs
Validate and normalize URLs before generation so broken, unsafe, or malformed destinations do not become printed assets.
Monitor analytics after deployment
Use scan analytics to confirm that codes are being scanned, placements are working, and campaigns are routing users to the intended destination.
QR Code API Glossary
We define these terms consistently across QR-Build's product, API, and documentation so developers, marketers, and product managers can make the same implementation decisions.
API key
An API key is a unique credential string that authenticates each request to the QR-Build API and connects usage to your account.
Endpoint
An endpoint is a specific URL your client sends requests to, such as POST /v1/qr for generation or GET /v1/qr/{id}/analytics for reporting.
Dynamic QR
A dynamic QR code is a QR code whose encoded URL points to a server-managed redirect layer, allowing the final destination to change after the QR is printed.
Redirect layer
A redirect layer is the QR-Build-managed URL encoded in a dynamic QR code; it forwards scanners to the current destination and enables analytics.
Scan analytics
Scan analytics are data collected when a dynamic QR code is scanned, including count, timestamp, device type, and geographic location.
Base64
Base64 is a binary-to-text encoding that lets QR image data travel inside JSON or HTML without a separate image file request.
Webhook
A webhook is an HTTP callback that notifies your server when a scan event or QR workflow event occurs.
QR Code API FAQ
Answers to developer, product, and integration questions about QR-Build API usage.
What is a QR code API?
A QR code API is a REST endpoint that accepts QR parameters such as type, URL, size, and format, then returns a QR code image or data object. It lets developers generate QR codes from application code instead of using a manual generator.
How do I generate a QR code with an API?
Authenticate with an API key, send a POST request with the QR parameters, and read the returned PNG, SVG, or JSON response. The simplest URL QR integration is a server-side HTTP request with a JSON body.
Is the QR-Build API free?
QR-Build offers free access for getting started with static QR generation. Dynamic QR codes, scan analytics, higher volume, and production features may require a paid plan; verify current details on the pricing page.
What output formats does the QR code API support?
The API supports PNG, SVG, base64, and JSON-style responses. Use PNG for simple print and email, SVG for scalable web or print rendering, and JSON or base64 when your application needs metadata and embedded image data.
What is the difference between static and dynamic QR codes via API?
A static QR code encodes the final destination directly into the image. A dynamic QR code encodes a redirect layer, so the destination can be edited later and scan analytics can be collected.
Can I update a dynamic QR code's destination via API?
Yes. Send a PATCH request to the QR code management endpoint with the new destination URL. The printed QR image does not need to be regenerated because the redirect layer routes future scans to the updated destination.
How do I generate bulk QR codes via API?
Use a batch request with an array of QR parameters. The API can return generated assets as a ZIP archive, a job result, or a JSON array depending on volume and account configuration.
What QR code types can I generate via the API?
As of 2026, QR-Build supports URL, WiFi, vCard, PDF, email, phone, menu, coupon, crypto, PayPal, calendar, and bulk QR workflows through API-oriented generation.
What authentication does the QR code API use?
The API uses API key authentication. Send the key as a Bearer token in the Authorization header and keep it server-side.
How do I keep my API key secure?
Store API keys in environment variables or a secret manager, make QR-Build calls from your server, never expose keys in client-side JavaScript, and rotate keys if they are committed or shared accidentally.
Can I access scan analytics via the API?
Yes. For dynamic QR codes, the analytics endpoint can return scan count, scan timestamps, device type, and location data. For dashboard-based analysis, see our QR code analytics guide.
What programming languages work with the QR code API?
Any language that can make HTTPS requests can use the API, including JavaScript, TypeScript, Python, Ruby, PHP, Go, Swift, Kotlin, Java, and C#.
What image size should I request for print use?
For print, request a large PNG or use SVG when possible. SVG is resolution-independent, while PNG should be sized high enough for the final printed dimensions and scan distance.
When should I use a QR code API instead of a manual generator?
Use the API for scale, automation, product integration, real-time generation, or campaign workflows. Use a manual generator for occasional one-off QR codes that do not need automation.
Can I use the QR code API in a mobile app?
Yes, but route calls through your server and deliver the generated image URL or data to the app. Do not embed your API key in an iOS or Android binary because it can be extracted.
Связанные ресурсы QR-Build
Встройте генерацию QR в свой продукт
Начните с бесплатного API-ключа, протестируйте статическую генерацию, затем добавьте управление динамическими QR, массовые процессы и аналитику сканирований, когда они понадобятся приложению.
Rate limits и детали тарифов со временем меняются; перед развертыванием проверьте актуальные production-лимиты.
