Guia Rápido da API de QR Code

A API do QR Code Genius permite gerar QR codes de forma programática: imagens PNG totalmente estilizadas, lotes em massa com rastreamento de escaneamentos e imagens leves que você pode incorporar diretamente em uma página web ou e-mail.

Crie uma API key

1. Faça login e abra o Painel de Desenvolvedores.
2. Clique em Criar API Key e dê um nome a ela.
3. Copie a chave imediatamente — ela é exibida apenas uma vez. Nossos servidores armazenam somente um hash seguro, portanto uma chave perdida precisa ser revogada e substituída.

As chaves têm este formato:

qrc_9f8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c...

URL base

https://www.qrcodegenius.com/api/v1

Sua primeira requisição

Envie sua chave no cabeçalho Authorization e faça um POST com o conteúdo que deseja codificar:

curl -X POST https://www.qrcodegenius.com/api/v1/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "data": "https://example.com", "width": 512, "height": 512 }'

A resposta contém o QR code como uma data URL PNG em base64, além do seu uso atual:

{
  "success": true,
  "data": "data:image/png;base64,iVBORw0KGgo...",
  "meta": { "usage_count": 1, "remaining": 49, "strategy": "monthly" }
}

Endpoints

• POST /qr — gera um único QR code totalmente estilizado. Veja Gerar um QR code.
• POST /qr/bulk — gera até 100 QR codes em uma única chamada e os salva na sua conta, opcionalmente como códigos dinâmicos rastreáveis (plano Pro). Veja Geração de QR em massa.
• GET /render — um PNG rápido e cacheável que você pode usar diretamente em uma tag img. Veja Incorporar uma imagem QR.

Planos e limites

• Free: 50 requisições de API por mês.
• Pro: 1.000 requisições de API por mês, além de acesso à geração em massa.
• Os créditos comprados são usados automaticamente quando a franquia mensal se esgota.

Veja Erros e limites de requisições para detalhes sobre cotas e tratamento de erros.