Создавайте статические QR-коды через публичный API

Руководство по API QR Code Crafter для агентов, внутренних инструментов и пакетной генерации: OpenAPI, WebMCP, ai.txt, bulk ZIP и экспорт SVG, PNG, JPG, WebP, PDF, EPS.

QR API

Создание запроса QR API

Настройте и протестируйте запрос к общедоступному QR API.

19 из 2048 символов

Запрос отправляется только после отправки формы.

Примеры запросов

cURL

curl -X POST 'https://qrcodecrafter.com/.netlify/functions/generate-qr' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"value":"https://example.com","format":"svg","size":1024,"margin":4,"fgColor":"#000000","bgColor":"#FFFFFF","errorCorrectionLevel":"H"}'

JavaScript fetch

const response = await fetch("https://qrcodecrafter.com/.netlify/functions/generate-qr", {
  method: 'POST',
  headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "value": "https://example.com",
    "format": "svg",
    "size": 1024,
    "margin": 4,
    "fgColor": "#000000",
    "bgColor": "#FFFFFF",
    "errorCorrectionLevel": "H"
  }),
})

if (!response.ok) throw new Error(`QR API request failed: ${response.status}`)
const qr = await response.json()

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 endpointGET или POST /.netlify/functions/generate-qrСоздает один статический QR asset из финального payload.
Bulk endpointPOST /.netlify/functions/generate-qr-bulkСоздает ZIP из CSV rows или JSON row objects.
Bulk limit1-50 rows per requestДержит публичные agent workflows в безопасных границах.
formatsvg, png, jpg, webp, pdf, epsВыбирает тип файла для web, документов, дизайна или печати.
size256-4096Задает размеры raster image и layout export.
errorCorrectionLevelL, M, Q, HВыбирайте H для логотипа, печати или сложных условий сканирования.
Response metadatacontentType, extension, byteLength, width, height, unitПодтверждает, что сохраненный файл соответствует запросу.
DiscoveryOpenAPI, 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.

Руководства: печать

API QR-кодов следует рассматривать как процесс публикации, а не просто как созданное изображение. Перед размещением кода в открытых материалах подтвердите назначение, выберите формат экспорта, проверьте готовый файл и назначьте ответственного.

Перед использованием API QR-кодов в печатных материалах, на упаковке, вывесках, в письмах, документах, приложениях или автоматизациях сохраните краткую запись о выпуске: закодированное значение, имя файла, формат экспорта, место размещения, ответственного и результат проверки. Эта запись поможет внести исправления позднее.

QR-код для URL: HTTPS

Для API QR-кодов убедитесь, что закодированный URL, контактные данные, платёжная инструкция, файл или действие в приложении верны, находятся под контролем нужной команды, доступны на мобильных устройствах и подходят людям, которые будут сканировать код.

Выбрать формат

Сохраняйте исходные файлы SVG, PDF или EPS для печати, упаковки, вывесок и инструментов дизайна. Для сайтов, писем, документов и цифровых размещений используйте PNG, JPG, WebP или SVG и не допускайте непредвиденного сжатия готового кода.

сканирование

Перед публикацией отсканируйте предпросмотр в браузере, скачанный файл, размещённый макет, экспортированный PDF, материал после загрузки в CMS, предпросмотр письма и физический пробный экземпляр с реалистичных расстояний, под разными углами, при разном освещении и на разных устройствах.

Компания

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

API QR-кодов

Когда требуется много QR-файлов, используйте единые правила именования, проверки манифеста, параметры OpenAPI или WebMCP и валидацию формата вывода до передачи материалов командам дизайна, печати или контента.

статические и динамические QR-коды

Проверяйте API QR-кодов после изменений кампании, ребрендинга, переноса домена, обновления платёжных данных, изменений в магазинах приложений, миграции документов или аналитики, чтобы публичные QR-коды не вели на устаревшие или небезопасные ресурсы.

Обратная связь

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

Доступность

Размещайте рядом с кодом текст, объясняющий действие сканирования, поддерживайте высокий контраст, избегайте слишком маленьких размеров и убедитесь, что назначение работает в мобильных браузерах, со скринридерами, настройками уменьшенного движения и клавиатурной навигацией.

Генерация QR-кодов через API

  1. 1

    Выберите single или bulk

    Используйте generate-qr для одного файла или generate-qr-bulk для ZIP с несколькими static QR files.

  2. 2

    Соберите финальный payload

    Подготовьте URL, Wi-Fi string, vCard, event, payment URI, text, CSV или row objects ровно в том виде, который должен прочитать scanner.

  3. 3

    Выберите output format

    SVG/PDF/EPS подходят для печати и дизайна; PNG/JPG/WebP - для digital publishing и preview.

  4. 4

    Проверьте response

    Подтвердите success, content type, byte length, dimensions, extension и ZIP manifest перед сохранением файла.

  5. 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?

WebMCP — предлагаемый стандарт, который работает только в поддерживаемой видимой вкладке браузера или webview. Проверяйте инструменты generate_qr и generate_bulk_qr, зарегистрированные на текущей странице: одного манифеста недостаточно, чтобы их вызвать. Headless- и серверным клиентам следует использовать HTTP-эндпоинты OpenAPI.

Создает ли 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.