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.
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.
Guias: impressão
Crie QR Codes estáticos com uma API pública. QR Code estático. Baixar SVG, PNG, JPG, WebP, PDF, EPS. leitura. checklists de pré-impressão de QR. Pré-visualização. Personalizar QR Code. Sem conta. 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.
Crie QR Codes estáticos com uma API pública. QR Code de URL. Crie no navegador. impressão. uso digital. Acessibilidade. segurança e privacidade de QR. formatos de arquivo de QR. leitor de QR code. Use the same checklist for websites, posters, packaging, receipts, menus, classroom handouts, payment notices, and customer support material.
QR Code de URL: HTTPS
Crie QR Codes estáticos com uma API pública: QR Code de URL, Crie no navegador, HTTPS, leitura. QR Code estático. Links prontos para analytics. UTM. segurança e privacidade de QR.
Selecionar formato
impressão: SVG, PDF, EPS. uso digital: PNG, JPG, WebP, SVG. formatos de arquivo de QR. Baixar. Exportações vetoriais. Selecionar formato.
leitura
leitura. Pré-visualização. leitor de QR code. checklists de pré-impressão de QR. impressão. uso digital. Personalizar. Test the generator preview, downloaded file, placed artwork, CMS upload, exported PDF, and one physical proof before approving production.
Empresa
Crie QR Codes estáticos com uma API pública: QR Code de URL, Baixar, SVG, PNG, JPG, WebP, PDF, EPS, impressão, uso digital, leitura. Empresa. Guias. Feedback.
API de QR Code
API de QR Code. OpenAPI. WebMCP. ai.txt. llms.txt. fluxos de QR em lote. Baixar SVG, PNG, JPG, WebP, PDF, EPS. QR Code estático.
QR estático versus dinâmico
Crie QR Codes estáticos com uma API pública. QR Code estático. Sem limite de leituras. QR Code de URL. Links prontos para analytics. segurança e privacidade de QR. Crie no navegador. leitura.
Feedback
QR Code de URL. QR Code de chamada. QR Code de e-mail. Acessibilidade. leitura. Feedback. QR Code de SMS.
Acessibilidade
Acessibilidade. leitura. impressão. uso digital. QR Code de URL. Crie no navegador. Pré-visualização.
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?
Sim. As páginas ao vivo registram ferramentas de execução generate_qr e generate_bulk_qr quando modelContext está disponível e expõem marcação declarativa de formulário para leitores que leem atributos toolname.
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.