API QR-кодов
API QR Code Crafter создает статические QR-файлы через публичный Netlify Function endpoint. Его можно использовать для URL, Wi-Fi, vCard, событий, геолокации, платежных payload, ссылок на приложения, социальных профилей и обычного текста.
AI-агенты и внутренние клиенты могут прочитать контракт через OpenAPI, WebMCP, ai.txt, llms.txt и runtime tools на живых страницах. Это снижает риск ошибок, когда агент пытается угадать поля формы или параметры запроса.
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
Для одного QR-файла используйте /.netlify/functions/generate-qr через GET или POST. POST JSON лучше подходит для длинных URL, vCard, event, Wi-Fi, логотипов и сценариев, где нужна метаинформация о файле.
Для массовой генерации используйте /.netlify/functions/generate-qr-bulk с CSV или row objects. Endpoint возвращает ZIP с QR-файлами, manifest.csv и manifest.json, ограниченный публичным лимитом 50 строк.
API создает статические QR assets, а не динамический сервис аналитики сканов. Если нужна отчетность по кампании, сначала сформируйте UTM URL или собственный redirect, а затем закодируйте его в статический QR-код.
Руководства
Один QR-файл
GET query или POST JSON к generate-qr создает один QR asset. POST response возвращает base64 data, filename, content type, extension, width, height и unit.
Discovery для агентов
/.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt и /llms.txt описывают schemas, лимиты, форматы и примеры запросов.
Шесть форматов экспорта
Один и тот же запрос может вернуть SVG, PNG, JPG, WebP, PDF или EPS. SVG/PDF/EPS подходят для печати, PNG/WebP - для цифровой публикации.
Bulk QR generation
Bulk endpoint обрабатывает до 50 строк и возвращает ZIP-архив с QR-файлами и manifest, который удобно проверять в downstream-системах.
Статическая модель без лишней зависимости
Payload хранится прямо в QR-паттерне. Для сканирования не нужен аккаунт QR-провайдера, активная подписка, scan quota или обязательный redirect.
Проверяемая метаинформация
Агент может проверить byteLength, dimensions, extension, contentType, fileCount и manifest до загрузки файла в CMS, Drive, печатный процесс или другой инструмент.
Параметры QR code API
| Параметр | Допустимое значение | Назначение |
|---|---|---|
| Single endpoint | GET или POST /.netlify/functions/generate-qr | Создает один статический QR asset из финального payload. |
| Bulk endpoint | POST /.netlify/functions/generate-qr-bulk | Создает ZIP из CSV rows или JSON row objects. |
| Bulk limit | 1-50 rows per request | Держит публичные agent workflows в безопасных границах. |
| format | svg, png, jpg, webp, pdf, eps | Выбирает тип файла для web, документов, дизайна или печати. |
| size | 256-4096 | Задает размеры raster image и layout export. |
| errorCorrectionLevel | L, M, Q, H | Выбирайте H для логотипа, печати или сложных условий сканирования. |
| Response metadata | contentType, extension, byteLength, width, height, unit | Подтверждает, что сохраненный файл соответствует запросу. |
| Discovery | OpenAPI, WebMCP, ai.txt, llms.txt | Помогает агентам и API-клиентам читать текущий контракт без guessing. |
| Campaign reporting | Кодируйте UTM URL или собственный redirect | Статический QR не создает dashboard сканов; аналитика идет через destination workflow. |
Как агент должен вызывать QR code API
Надежный workflow начинается с discovery, затем формируется payload, выбирается формат и проверяется метаинформация перед передачей файла дальше.
Начните с discovery
Прочитайте /ai.txt, /llms.txt или /.well-known/openapi.json, чтобы клиент использовал актуальный endpoint, schema, examples и supported formats.
Используйте POST для automation
POST JSON избегает query string limits для длинных URL, vCard, event, Wi-Fi, payment payload и logo data URL.
Используйте GET для прямого download
GET возвращает binary asset напрямую и exposes X-QR-Width, X-QR-Height, X-QR-Unit и X-QR-Bytes.
Проверяйте сохраненный файл
Сверяйте contentType, extension, byteLength, width, height и unit перед загрузкой в CMS, Google Drive, print workflow или другой agent.
Bulk QR generation workflow
Bulk endpoint подходит для labels, учебных материалов, packaging, меню, event badges, campaign variants и QR-файлов из структурированных данных.
Отправьте CSV или row objects
Используйте CSV filename,value или JSON rows с value и необязательным filename. Пустые строки, небезопасные имена и слишком большие payload отклоняются.
Выберите один формат для batch
Задайте SVG, PNG, JPG, WebP, PDF или EPS один раз. SVG хорош для объемной automation; PDF или EPS - для передачи в печать.
Запрашивайте ZIP при необходимости архива
Accept: application/zip возвращает binary ZIP. JSON response полезен, если агенту нужны base64 ZIP data, byteLength, fileCount и manifest.
Используйте manifest для аудита
manifest.csv и manifest.json связывают source rows с filename, status и byte counts, чтобы downstream system могла отследить результат.
Поддерживаемые статические payload
API кодирует ровно тот payload, который вы отправляете. Валидируйте финальную строку в своем workflow до генерации и публикации QR-файла.
Маркетинговые ссылки
Кодируйте HTTPS URL, campaign URL с UTM, app store pages, social profiles, menu pages, PDF landing pages и Google review links.
Действия устройства
Кодируйте Wi-Fi strings, mailto links, SMS actions, phone links, WhatsApp links, calendar events, map coordinates и vCard contacts.
Платежные payload
Кодируйте PIX EMV, UPI URI, Swish links и crypto wallet URI после проверки recipient, amount, memo и currency в вашей системе.
Дизайн и печать
Используйте SVG, PDF или EPS для production artwork; PNG, JPG или WebP - для preview, документов, email и web publishing.
Checklist для agent integration
- Читайте /ai.txt или /.well-known/openapi.json до отправки request.
- Используйте POST JSON для vCard, event, Wi-Fi, payment, logo и long payload.
- Используйте bulk endpoint только для batch до 50 rows.
- Отправляйте Accept: application/zip, когда агенту нужен прямой binary ZIP.
- Указывайте понятный User-Agent для automated integration.
- Уважайте Retry-After в ответах 429 и 503.
- Декодируйте base64 data из POST response и сохраняйте с returned extension.
- Проверяйте byteLength, dimensions, fileCount и manifest metadata до handoff.
- Запускайте scan test для каждого content payload и export format перед production use.
- Для campaign tracking сначала создавайте UTM URL или свой redirect, затем кодируйте его в QR.
Руководства: печать
Создавайте статические QR-коды через публичный API. Статический QR-код. Скачать SVG, PNG, JPG, WebP, PDF, EPS. сканирование. чек-листы предпечатной проверки QR. Предпросмотр. Настроить QR-код. Без аккаунта. Keep the destination, owner, file name, publication channel, proof result, and review date with the campaign notes so printed and shared QR assets can be checked later.
Создавайте статические QR-коды через публичный API. QR-код для URL. Создание в браузере. печать. цифровое использование. Доступность. безопасность и приватность QR. форматов файлов QR. сканер QR-кодов. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.
QR-код для URL: HTTPS
Создавайте статические QR-коды через публичный API: QR-код для URL, Создание в браузере, HTTPS, сканирование. Статический QR-код. Ссылки для аналитики. UTM. безопасность и приватность QR.
Выбрать формат
печать: SVG, PDF, EPS. цифровое использование: PNG, JPG, WebP, SVG. форматов файлов QR. Скачать. Векторный экспорт. Выбрать формат.
сканирование
сканирование. Предпросмотр. сканер QR-кодов. чек-листы предпечатной проверки QR. печать. цифровое использование. Настроить. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.
Компания
Создавайте статические QR-коды через публичный API: QR-код для URL, Скачать, SVG, PNG, JPG, WebP, PDF, EPS, печать, цифровое использование, сканирование. Компания. Руководства. Обратная связь.
API QR-кодов
API QR-кодов. OpenAPI. WebMCP. ai.txt. llms.txt. массовые QR-процессы. Скачать SVG, PNG, JPG, WebP, PDF, EPS. Статический QR-код.
статические и динамические QR-коды
Создавайте статические QR-коды через публичный API. Статический QR-код. Без лимитов сканирования. QR-код для URL. Ссылки для аналитики. безопасность и приватность QR. Создание в браузере. сканирование.
Обратная связь
QR-код для URL. QR-код для звонка. QR-код для email. Доступность. сканирование. Обратная связь. QR-код для SMS.
Доступность
Доступность. сканирование. печать. цифровое использование. QR-код для URL. Создание в браузере. Предпросмотр.
Генерация QR-кодов через API
- 1
Выберите single или bulk
Используйте generate-qr для одного файла или generate-qr-bulk для ZIP с несколькими static QR files.
- 2
Соберите финальный payload
Подготовьте URL, Wi-Fi string, vCard, event, payment URI, text, CSV или row objects ровно в том виде, который должен прочитать scanner.
- 3
Выберите output format
SVG/PDF/EPS подходят для печати и дизайна; PNG/JPG/WebP - для digital publishing и preview.
- 4
Проверьте response
Подтвердите success, content type, byte length, dimensions, extension и ZIP manifest перед сохранением файла.
- 5
Протестируйте в финальном контексте
Сканируйте файл после вставки в layout, CMS, документ или print proof, чтобы automation-generated asset реально читался.
Частые вопросы
Какой endpoint у QR Code Crafter API?
Для одного QR-кода используйте /.netlify/functions/generate-qr с GET query parameters или POST JSON body. Для bulk ZIP используйте /.netlify/functions/generate-qr-bulk.
Может ли API создавать QR-коды массово?
Да. Отправьте CSV rows или JSON row objects в bulk endpoint. Ответ может быть JSON с base64 ZIP data или application/zip напрямую, если request использует Accept: application/zip.
Нужен ли аккаунт для API?
Публичная генерация доступна без аккаунта, если deployment не включает API key enforcement. Если ключ выдан, отправляйте X-Agent-Api-Key и обрабатывайте 401.
Какие форматы файлов возвращает API?
Публичный контракт поддерживает SVG, PNG, JPG, WebP, PDF и EPS.
Могут ли browser agents использовать WebMCP?
Да. Live pages регистрируют runtime tools generate_qr и generate_bulk_qr, когда доступен modelContext, и публикуют declarative form markup для scanners, которые читают toolname attributes.
Создает ли API dynamic tracking QR codes?
Нет. API создает static QR assets. Для измерения кампаний закодируйте UTM-tagged URL или redirect под вашим контролем до создания QR-кода.
API QR-кодов: QR code generator API?
API QR-кодов: QR code generator API. API QR code generator. qrcode API. QR API. generate QR code API. SVG, PNG, JPG, WebP, PDF, EPS.