API de QR Code
A API do QR Code Crafter cria arquivos de QR Code estático por meio de um ponto de extremidade público em Netlify Functions. Ela funciona para URLs, Wi-Fi, vCard, eventos, localização, cargas úteis de pagamento, links de app store, perfis sociais e texto simples.
Agentes de IA e ferramentas internas podem descobrir o contrato por OpenAPI, WebMCP, ai.txt, llms.txt e ferramentas de execução nas páginas ao vivo. Assim o cliente não precisa adivinhar parâmetros nem interpretar visualmente um formulário.
OpenAPI GenerateQrRequest: x-agent-recipes. WebMCP: api.agentRecipes. Payment content: PhonePe-compatible UPI, Swiss QR-bill, SEPA/GiroCode, iDEAL, MobilePay/Vipps, QRIS.
Para um único arquivo, chame /.netlify/functions/generate-qr por GET ou POST. Use POST JSON para cargas úteis longas, vCard, evento, Wi-Fi, dados de logo e fluxos de trabalho que precisam de metadados do arquivo.
Para vários arquivos, chame /.netlify/functions/generate-qr-bulk com CSV ou objetos de linha. O ponto de extremidade retorna um ZIP com os arquivos QR, manifest.csv e manifest.json, limitado publicamente a 50 linhas por requisição.
A API gera arquivos estáticos, não um serviço de rastreamento dinâmico. Para medir campanhas, crie antes uma URL com UTM ou um redirecionamento próprio e codifique esse destino final no QR Code estático.
Análise independente de recursos
Revisado em
Decisões principais
Ponto de extremidade de QR único
Consulta GET ou POST JSON para generate-qr cria um arquivo QR. A resposta POST inclui dados base64, nome de arquivo, tipo de conteúdo, extensão, largura, altura e unidade.
Descoberta legível por agentes
/.well-known/openapi.json, /openapi.yaml, /.well-known/webmcp.json, /ai.txt e /llms.txt descrevem esquemas, limites, formatos e exemplos de requisição.
Seis formatos de exportação
A mesma requisição pode retornar SVG, PNG, JPG, WebP, PDF ou EPS. Use SVG/PDF/EPS para impressão e PNG/WebP para publicação digital.
Fluxo de geração de QR em lote
O ponto de extremidade em lote processa até 50 linhas e retorna um ZIP com arquivos QR e manifestos legíveis por máquina.
Modelo estático com menos dependência
A carga útil fica gravada no próprio padrão do QR Code. A leitura não depende de conta, assinatura ativa, cota de leitura ou redirecionamento obrigatório de um fornecedor.
Metadados fáceis de validar
Agentes podem checar byteLength, dimensions, extension, contentType, fileCount e manifest antes de enviar o arquivo para CMS, Drive, fluxo de impressão ou outra ferramenta.
Opções de requisição da API de QR Code
| Opção | Valor aceito | Uso |
|---|---|---|
| Ponto de extremidade individual | GET ou POST /.netlify/functions/generate-qr | Cria um arquivo QR estático a partir da carga útil final. |
| Ponto de extremidade em lote | POST /.netlify/functions/generate-qr-bulk | Cria um ZIP a partir de linhas CSV ou objetos de linha JSON. |
| Limite do lote | 1-50 linhas por requisição | Mantém automações públicas e agentes dentro de limites seguros. |
| format | svg, png, jpg, webp, pdf, eps | Escolhe o tipo de arquivo para web, documentos, design ou impressão. |
| size | 256-4096 | Define dimensões para imagens raster e exportações de layout. |
| errorCorrectionLevel | L, M, Q, H | Escolha H para logo, impressão ou ambientes de scan mais difíceis. |
| Metadados da resposta | contentType, extension, byteLength, width, height, unit | Confirma que o arquivo salvo corresponde à requisição. |
| Arquivos de descoberta | OpenAPI, WebMCP, ai.txt, llms.txt | Ajuda agentes e clientes de API a ler parâmetros atuais sem adivinhar. |
| Relatórios de campanha | Codifique URL com UTM ou redirecionamento próprio | QR estático não cria dashboard do fornecedor; a medição fica no destino. |
Como agentes devem chamar a API de QR Code
Um fluxo de trabalho confiável começa pelos arquivos de descoberta, monta a carga útil final, escolhe o formato e valida metadados antes da entrega.
Comece pela descoberta
Leia /ai.txt, /llms.txt ou /.well-known/openapi.json para usar ponto de extremidade, esquema, exemplos e formatos suportados atuais.
Use POST para automação
POST JSON evita limites de parâmetros de consulta em URLs longas, vCard, eventos, Wi-Fi, cargas úteis de pagamento e URL de dados de logo.
Use GET para download direto
GET retorna o arquivo binário diretamente e expõe headers X-QR-Width, X-QR-Height, X-QR-Unit e X-QR-Bytes.
Valide o arquivo salvo
Confira contentType, extension, byteLength, width, height e unit antes de enviar para CMS, Google Drive, fornecedor de impressão ou outro agente.
Fluxo de geração de QR em lote
O ponto de extremidade em lote é útil para etiquetas, materiais de aula, embalagens, cardápios, crachás, variações de campanha e arquivos QR criados a partir de dados estruturados.
Envie CSV ou objetos de linha
Use CSV filename,value ou linhas JSON com value e filename opcional. Linhas vazias, nomes inseguros e cargas úteis grandes demais são recusados.
Escolha um formato comum
Defina SVG, PNG, JPG, WebP, PDF ou EPS para o lote. SVG funciona bem para automação em volume; PDF ou EPS para entrega de impressão.
Peça ZIP quando precisar de arquivo
Accept: application/zip retorna um ZIP binário. A resposta JSON fica disponível quando o agente precisa de dados ZIP em base64, byteLength, fileCount e manifest.
Use o manifest para auditoria
manifest.csv e manifest.json ligam cada linha de origem a filename, status e byte counts para rastrear o resultado no sistema seguinte.
Cargas úteis estáticas suportadas
A API codifica exatamente a carga útil enviada. Valide a string final no seu próprio fluxo de trabalho antes de gerar e publicar o arquivo QR.
Links de marketing e conteúdo
Codifique URLs HTTPS, URLs de campanha com UTM, páginas de app store, perfis sociais, cardápios, PDFs públicos e links de avaliação do Google.
Ações do dispositivo
Codifique Wi-Fi strings, mailto links, SMS actions, phone links, WhatsApp links, eventos de calendário, coordenadas de mapa e vCard contacts.
Cargas úteis de pagamento
Codifique PIX EMV, UPI URI, links Swish, VietQR, PromptPay e crypto wallet URI depois de validar recebedor, valor, memo e moeda no seu sistema.
Design e impressão
Use SVG, PDF ou EPS em arte de produção; use PNG, JPG ou WebP para prévias, documentos, e-mail e publicação web.
Checklist de integração para agentes
- Leia /ai.txt ou /.well-known/openapi.json antes de montar a requisição.
- Use POST JSON para vCard, evento, Wi-Fi, pagamento, logo e cargas úteis longas.
- Use o ponto de extremidade em lote apenas para lotes de até 50 linhas.
- Envie Accept: application/zip quando o agente precisar do ZIP binário direto.
- Defina um User-Agent descritivo para integrações automatizadas.
- Respeite Retry-After em respostas 429 e 503.
- Decodifique dados base64 da resposta POST e salve com a extensão retornada.
- Valide byteLength, dimensions, fileCount e metadados de manifest antes da entrega.
- Faça teste de leitura para cada carga útil de conteúdo e formato de exportação antes de usar em produção.
- Para medição de campanha, crie a URL com UTM ou redirecionamento próprio antes de gerar o QR.
Gerar QR Code pela API
- 1
Escolha individual ou em lote
Use generate-qr para um arquivo ou generate-qr-bulk para um ZIP com vários QR Codes estáticos.
- 2
Monte a carga útil final
Prepare URL, string Wi-Fi, vCard, evento, URI de pagamento, texto, CSV ou objetos de linha exatamente como o leitor deve ler.
- 3
Escolha o formato de saída
Use SVG/PDF/EPS para impressão e design; PNG/JPG/WebP para publicação digital e prévias.
- 4
Verifique a resposta
Confirme success, content type, byte length, dimensions, extension e manifest do ZIP antes de salvar arquivos.
- 5
Teste no contexto final
Escaneie o arquivo depois de inserido em layout, CMS, documento ou prova impressa para garantir que o ativo automatizado funcione na prática.
Perguntas frequentes
Qual é o ponto de extremidade da API do QR Code Crafter?
Use /.netlify/functions/generate-qr com parâmetros de consulta GET ou corpo POST JSON para um QR Code. Para ZIP em lote, use /.netlify/functions/generate-qr-bulk.
A API gera QR Codes em lote?
Sim. Envie linhas CSV ou objetos de linha JSON para o ponto de extremidade em lote. A resposta pode ser JSON com dados ZIP em base64 ou application/zip direto quando a requisição usa Accept: application/zip.
Preciso de conta para usar a API?
A geração pública está disponível sem conta enquanto a implantação não ativar verificação de chave de API. Se houver uma chave emitida, envie X-Agent-Api-Key e trate respostas 401.
Quais formatos de arquivo a API retorna?
O contrato público suporta SVG, PNG, JPG, WebP, PDF e EPS.
Agentes de navegador podem usar WebMCP?
O WebMCP é um padrão proposto e só funciona em uma guia visível ou visualização web compatível. Verifique as ferramentas generate_qr e generate_bulk_qr registradas na página atual; apenas o manifesto não permite executá-las. Clientes sem interface e do lado do servidor devem usar os pontos de acesso HTTP documentados pelo OpenAPI.
A API cria QR Codes dinâmicos com tracking?
Não. A API cria arquivos QR estáticos. Para medir visitas de campanha, codifique uma URL com UTM ou redirecionamento próprio antes de gerar o QR Code.
API de QR Code: QR code generator API?
API de QR Code: QR code generator API. API QR code generator. qrcode API. QR API. generate QR code API. SVG, PNG, JPG, WebP, PDF, EPS.