Tạo QR code tĩnh bằng API công khai

Hướng dẫn API QR Code Crafter cho agent, công cụ nội bộ và workflow tạo hàng loạt: OpenAPI, WebMCP, ai.txt, bulk ZIP và xuất SVG, PNG, JPG, WebP, PDF, EPS.

API QR

Tạo yêu cầu API QR

Cấu hình và kiểm thử yêu cầu tới API QR công khai.

19 trên 2048 ký tự

Yêu cầu chỉ được gửi khi bạn gửi biểu mẫu.

Ví dụ yêu cầu

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 code

API QR Code Crafter tạo file QR tĩnh thông qua một Netlify Function endpoint công khai. Bạn có thể dùng cho URL, Wi-Fi, vCard, sự kiện, vị trí, payload thanh toán, app store link, social profile và văn bản thường.

AI agent và công cụ nội bộ có thể đọc contract qua OpenAPI, WebMCP, ai.txt, llms.txt và runtime tools trên trang live. Điều này giúp agent không phải đoán field hoặc scrape form bằng thị giác.

OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.

Để tạo một file QR, gọi /.netlify/functions/generate-qr bằng GET hoặc POST. POST JSON phù hợp hơn cho URL dài, vCard, event, Wi-Fi, logo data và workflow cần metadata file.

Để tạo nhiều file, gọi /.netlify/functions/generate-qr-bulk với CSV hoặc row objects. Endpoint trả về ZIP chứa file QR, manifest.csv và manifest.json, với public limit 50 rows.

API này tạo static QR asset, không phải dynamic scan tracking service. Nếu cần báo cáo chiến dịch, hãy tạo UTM URL hoặc redirect do bạn kiểm soát trước, rồi encode URL đó vào QR tĩnh.

Đánh giá tính năng độc lập

Đã xem xét vào

Nguồn chính thức

Hướng dẫn

Single QR endpoint

GET query hoặc POST JSON tới generate-qr tạo một QR asset. POST response có base64 data, filename, content type, extension, width, height và unit.

Agent-readable discovery

/.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt và /llms.txt mô tả schema, giới hạn, format và request examples.

Sáu định dạng export

Cùng một request có thể trả về SVG, PNG, JPG, WebP, PDF hoặc EPS. Dùng SVG/PDF/EPS cho in ấn và PNG/WebP cho kênh digital.

Bulk QR generation workflow

Bulk endpoint xử lý tối đa 50 rows và trả về ZIP archive với QR files cùng manifest để hệ thống downstream kiểm tra.

Mô hình tĩnh, ít phụ thuộc

Payload nằm trực tiếp trong QR pattern. Khi scan không cần tài khoản QR provider, subscription còn hiệu lực, scan quota hoặc provider redirect bắt buộc.

Metadata dễ xác minh

Agent có thể kiểm tra byteLength, dimensions, extension, contentType, fileCount và manifest trước khi lưu vào CMS, Drive, print workflow hoặc tool khác.

QR code API request options

Tùy chọnGiá trị nhậnKhi dùng
Single endpointGET hoặc POST /.netlify/functions/generate-qrTạo một static QR asset từ final payload.
Bulk endpointPOST /.netlify/functions/generate-qr-bulkTạo ZIP từ CSV rows hoặc JSON row objects.
Bulk limit1-50 rows per requestGiữ public agent workflow trong phạm vi an toàn.
formatsvg, png, jpg, webp, pdf, epsChọn loại file cho web, document, design hoặc print.
size256-4096Điều chỉnh dimension cho raster image và layout export.
errorCorrectionLevelL, M, Q, HChọn H cho logo, in ấn hoặc môi trường scan khó hơn.
Response metadatacontentType, extension, byteLength, width, height, unitXác nhận file đã lưu đúng với request.
Discovery filesOpenAPI, WebMCP, ai.txt, llms.txtGiúp agent và API client đọc parameter hiện tại mà không phải guessing.
Campaign reportingEncode UTM URL hoặc redirect riêngStatic QR không tạo provider dashboard; reporting nằm ở destination workflow.

Cách agent nên gọi QR code API

Workflow agent ổn định bắt đầu bằng discovery, xây payload cuối cùng, chọn format và xác minh metadata trước khi handoff file.

Bắt đầu từ discovery

Đọc /ai.txt, /llms.txt hoặc /.well-known/openapi.json để client dùng endpoint, schema, examples và supported formats mới nhất.

Dùng POST cho automation

POST JSON tránh query string limit cho URL dài, vCard, event, Wi-Fi, payment payload và logo data URL.

Dùng GET cho direct download

GET trả binary asset trực tiếp và expose các header X-QR-Width, X-QR-Height, X-QR-Unit và X-QR-Bytes.

Xác minh file đã lưu

Kiểm tra contentType, extension, byteLength, width, height và unit trước khi chuyển file sang CMS, Google Drive, print workflow hoặc agent khác.

Bulk QR generation workflow

Bulk endpoint phù hợp cho asset labels, lớp học, packaging, menu, event badges, campaign variants và QR files tạo từ dữ liệu có cấu trúc.

Gửi CSV hoặc row objects

Dùng CSV filename,value hoặc JSON rows có value và optional filename. Row rỗng, filename không an toàn và payload quá lớn sẽ bị từ chối.

Chọn một format chung

Set SVG, PNG, JPG, WebP, PDF hoặc EPS cho cả batch. SVG phù hợp automation số lượng lớn; PDF hoặc EPS phù hợp print handoff.

Yêu cầu ZIP khi cần archive

Accept: application/zip trả về binary ZIP. JSON response có sẵn khi agent cần base64 ZIP data, byteLength, fileCount và manifest.

Dùng manifest để audit

manifest.csv và manifest.json map source rows với filename, status và byte counts để downstream system trace kết quả batch.

Static payload được hỗ trợ

API encode đúng payload bạn gửi. Hãy validate final string trong workflow của bạn trước khi tạo và publish QR file.

Marketing và content links

Encode HTTPS URL, UTM campaign URL, app store page, social profile, menu, PDF landing page và Google review link.

Device actions

Encode Wi-Fi strings, mailto links, SMS actions, phone links, WhatsApp links, calendar events, map coordinates và vCard contact payload.

Payment payloads

Encode VietQR, PromptPay, UPI URI, PIX EMV và crypto wallet URI sau khi recipient, amount, memo và currency được validate trong hệ thống của bạn.

Design và print output

Dùng SVG, PDF hoặc EPS cho production artwork; dùng PNG, JPG hoặc WebP cho preview, document, email và web publishing.

Checklist tích hợp agent

  • Đọc /ai.txt hoặc /.well-known/openapi.json trước khi client tạo request.
  • Dùng POST JSON cho vCard, event, Wi-Fi, payment, logo và long payload.
  • Chỉ dùng bulk endpoint cho batch tối đa 50 rows.
  • Gửi Accept: application/zip khi agent cần binary ZIP trực tiếp.
  • Đặt User-Agent mô tả rõ cho automated integration.
  • Tôn trọng Retry-After trong response 429 và 503.
  • Decode base64 data từ POST response và lưu bằng returned extension.
  • Xác minh byteLength, dimensions, fileCount và manifest metadata trước handoff.
  • Chạy scan test cho từng content payload và export format trước production use.
  • Để campaign tracking, tạo UTM URL hoặc redirect riêng trước khi encode QR.

Hướng dẫn: in ấn

API QR code nên được xem là một quy trình xuất bản, không chỉ là ảnh được tạo. Hãy xác nhận đích đến, chọn định dạng xuất, thử tệp hoàn chỉnh và chỉ định người phụ trách trước khi mã xuất hiện trong tài liệu công khai.

Trước khi dùng API QR code trên ấn phẩm in, bao bì, biển hiệu, email, tài liệu, ứng dụng hoặc quy trình tự động, hãy lưu một ghi chú phát hành ngắn gồm giá trị đã mã hóa, tên tệp, định dạng xuất, vị trí sử dụng, người phụ trách và kết quả kiểm tra. Hồ sơ này giúp có thể sửa đổi về sau.

QR code URL: HTTPS

Với API QR code, hãy xác minh URL được mã hóa, thông tin liên hệ, hướng dẫn thanh toán, tệp hoặc thao tác trong ứng dụng là chính xác, do đúng nhóm quản lý, dùng được trên thiết bị di động và phù hợp với những người có thể quét mã.

Chọn định dạng

Giữ tệp gốc SVG, PDF hoặc EPS cho in ấn, bao bì, biển hiệu và công cụ thiết kế. Dùng PNG, JPG, WebP hoặc SVG cho website, email, tài liệu và vị trí kỹ thuật số, đồng thời tránh nén mã cuối cùng ngoài dự kiến.

lượt quét

Trước khi phát hành, hãy quét bản xem trước trong trình duyệt, tệp đã tải xuống, bố cục đã đặt, PDF đã xuất, nội dung tải lên CMS, bản xem trước email và bản in thử trong các điều kiện thực tế về khoảng cách, góc quét, ánh sáng và thiết bị.

Công ty

Ghi lại người phụ trách mã QR, đích đến, tệp nguồn, định dạng xuất, vị trí sử dụng, ngày xuất bản, thiết bị kiểm tra, ngày rà soát và điều kiện thay thế để các mã QR tĩnh dùng lâu vẫn đáng tin cậy.

API QR code

Khi cần nhiều tệp QR, hãy dùng quy ước tên nhất quán, kiểm tra tệp kê khai, tham số OpenAPI hoặc WebMCP và xác thực định dạng đầu ra trước khi bàn giao tài sản cho nhóm thiết kế, in ấn hoặc nội dung.

QR code tĩnh và QR code động

Hãy rà soát API QR code sau khi chiến dịch, thương hiệu, tên miền, thông tin thanh toán, cửa hàng ứng dụng, tài liệu hoặc hệ thống phân tích thay đổi để mã QR công khai không dẫn tới đích đến lỗi thời hay không an toàn.

Phản hồi

Thêm văn bản đích đến dễ đọc, URL rút gọn, thông tin liên hệ hỗ trợ hoặc hướng dẫn in khi việc quét là thiết yếu cho hoạt động, nhạy cảm về khả năng tiếp cận hoặc có thể diễn ra trong môi trường kết nối kém.

Trợ năng

Đặt văn bản gần mã để giải thích thao tác quét, duy trì độ tương phản cao, tránh đặt mã quá nhỏ và bảo đảm đích đến hoạt động với trình duyệt di động, trình đọc màn hình, tùy chọn giảm chuyển động và điều hướng bằng bàn phím.

Tạo QR code bằng API

  1. 1

    Chọn single hoặc bulk

    Dùng generate-qr cho một asset, hoặc generate-qr-bulk cho ZIP chứa nhiều static QR files.

  2. 2

    Xây final payload

    Chuẩn bị URL, Wi-Fi string, vCard, event, payment URI, text, CSV hoặc row objects đúng như scanner cần đọc.

  3. 3

    Chọn output format

    Chọn SVG/PDF/EPS cho print và design; chọn PNG/JPG/WebP cho digital publishing và preview.

  4. 4

    Verify response

    Xác nhận success, content type, byte length, dimensions, extension và ZIP manifest trước khi lưu file.

  5. 5

    Test trong context cuối

    Scan file sau khi đưa vào layout, CMS, document hoặc proof print để asset tạo tự động vẫn đọc được trong thực tế.

Câu hỏi thường gặp

Endpoint của QR Code Crafter API là gì?

Dùng /.netlify/functions/generate-qr với GET query parameters hoặc POST JSON body cho một QR code. Dùng /.netlify/functions/generate-qr-bulk cho bulk ZIP.

API có tạo QR codes hàng loạt được không?

Có. Gửi CSV rows hoặc JSON row objects tới bulk endpoint. Response có thể là JSON với base64 ZIP data hoặc application/zip trực tiếp nếu request dùng Accept: application/zip.

API có cần tài khoản không?

Public generation có sẵn không cần tài khoản trừ khi deployment bật API key enforcement. Nếu có key, gửi header X-Agent-Api-Key và xử lý response 401.

API trả về những QR file formats nào?

Public contract hỗ trợ SVG, PNG, JPG, WebP, PDF và EPS.

Browser agents có dùng WebMCP được không?

WebMCP là một tiêu chuẩn đang được đề xuất và chỉ hoạt động trong thẻ trình duyệt hoặc webview hiển thị có hỗ trợ. Hãy kiểm tra các công cụ generate_qr và generate_bulk_qr đã đăng ký trên trang hiện tại; chỉ có manifest không có nghĩa là công cụ có thể được gọi. Máy khách headless và phía máy chủ nên dùng các điểm cuối HTTP OpenAPI.

API có tạo dynamic tracking QR codes không?

Không. API tạo static QR assets. Để đo campaign visits, encode UTM-tagged URL hoặc redirect do bạn kiểm soát trước khi tạo QR code.

API QR code: QR code generator API?

API QR code: QR code generator API. API QR code generator. qrcode API. QR API. generate QR code API. SVG, PNG, JPG, WebP, PDF, EPS.