Guia para desenvolvedores
O QR Code Crafter publica OpenAPI e arquivos de descoberta para IA, permitindo que agentes encontrem endpoint, formatos, limites e schema.
A API aceita valor, formato, tamanho, cores, nível de correção, margem e logo opcional em data URL.
Decisões principais
Descoberta legível por agentes
Use /ai.txt, /.well-known/openapi.json, /openapi.yaml e /.well-known/webmcp.json.
Seis formatos
Gere SVG, PNG, JPG, WebP, PDF e EPS com a mesma estrutura de requisição.
Chaves opcionais
Inclua X-Agent-Api-Key quando houver credencial; o acesso público continua disponível salvo enforcement.
Opções da requisição
| Opção | Valores aceitos | Uso |
|---|---|---|
| format | svg, png, jpg, webp, pdf, eps | Escolhe o tipo de ativo |
| size | 256-4096 | Define dimensões da imagem |
| errorCorrectionLevel | L, M, Q, H | Use H com logo ou impressão difícil |
Checklist de integração para agentes
- Defina um User-Agent descritivo para identificar a integração.
- Respeite cabeçalhos Retry-After em respostas 429 e 503.
- Decodifique o campo data em base64 e salve com a extensão retornada.
- Rode um smoke test ao vivo por payload e formato antes da produção.
Planeje melhor API de QR Code
- 1
QR Code de URL
Crie um QR Code de URL estático grátis para QR Code de URL.
- 2
Personalizar
Personalizar QR Code.
- 3
Baixar
Baixar SVG, PNG, JPG, WebP, PDF, EPS.
Perguntas frequentes
Qual endpoint gera QR Codes?
Use /.netlify/functions/generate-qr com parâmetros GET ou corpo JSON via POST.
A API exige autenticação?
A chave é opcional. Inclua X-Agent-Api-Key se tiver uma e trate 401 caso o enforcement seja ativado.
Quais formatos a API retorna?
O contrato público oferece SVG, PNG, JPG, WebP, PDF e EPS.