API

QR Code por requisição HTTP

Um endpoint, doze tipos e o design inteiro em JSON. É o mesmo motor que desenha no editor — o que você vê ali é o que sai daqui.

Criar minha chave Ver a documentação

Disponível em todos os planos. O gratuito inclui 10 chamadas por dia.

O que você não precisa resolver

O mesmo motor do editor

Nada de uma biblioteca para o produto e outra para a API. O SVG que sai daqui é byte a byte o que o editor desenha.

Validação junto

Telefone normalizado, URL completada, CRC do PIX calculado, dígito verificador de CPF e CNPJ conferido. Você manda o campo, não o payload.

Vetor de verdade

SVG que escala de etiqueta a fachada sem escolher resolução — e sem servir um PNG borrado quando alguém amplia.

Nada expira

QR estático não depende de nós para funcionar. Se você parar de pagar, o que já foi impresso continua lendo.

Onde isso costuma entrar

Casos em que gerar um QR na mão não escala.

E-commerce e logística

Um QR por pedido na etiqueta, ligando ao rastreio. Gere no momento em que a etiqueta é impressa, não antes.

Ingressos e credenciais

Um código por participante, com identificador próprio, gerado junto com o ingresso e conferido na portaria.

Cardápio e mesas

Um QR por mesa apontando para o pedido daquela mesa. Cem mesas é uma chamada em laço, não cem downloads.

Cobrança com PIX

BR Code no padrão do Banco Central, com valor e identificador por cobrança, montado e validado do lado do servidor.

Produto com QR embutido

Convite, autenticação de dispositivo, compartilhamento — QR por usuário, gerado sob demanda e servido direto na sua interface.

Material impresso em escala

Milhares de peças variáveis num fluxo automatizado, cada uma com seu código, direto do seu servidor para a gráfica.

Três passos

Crie a chave
Em Minha conta. Ela aparece uma vez só e fica guardada com hash — nem nós conseguimos recuperá-la depois.
Chame o endpoint
GET para o caso rápido, POST quando quiser design. Sempre do seu servidor: chave em navegador é chave pública.
Use o SVG
Sirva direto, embuta como data URL ou mande para a gráfica. O arquivo é seu e não depende de nós.

Rápido, com o visual padrão

curl -H "Authorization: Bearer gq_suachave" \
  "https://app.qrcode.kadu.pro/api/v1/qr?data=exemplo.com.br&size=600" \
  -o qr.svg

Com o design completo

curl -X POST https://app.qrcode.kadu.pro/api/v1/qr \
  -H "Authorization: Bearer gq_suachave" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "pix",
    "data": {
      "key": "loja@exemplo.com.br",
      "name": "Loja Exemplo",
      "city": "Sao Paulo",
      "amount": "49.90",
      "txid": "PEDIDO10432"
    },
    "size": 1200,
    "design": {
      "dots": { "shape": "rounded", "color": "#582D1D" },
      "eyes": { "frameShape": "rounded", "ballShape": "circle" },
      "frame": { "style": "label-bottom", "label": "Pague com PIX" },
      "errorCorrection": "Q"
    }
  }'

A resposta

Por padrão vem o SVG. Com format=json vem também o payload final gravado no código — útil para registrar o que a normalização fez com a sua entrada.

{
  "payload": "00020126...6304A1B2",
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" ...>",
  "size": 1200
}

O que a API aceita

Recurso	Detalhe
Tipos	Os 12 estáticos: link, texto, Wi-Fi, SMS, WhatsApp, e-mail, telefone, PIX, cripto, localização, vCard e evento.
Design	dots, eyes, background, frame, logo, errorCorrection e quietZone — o mesmo formato que o editor salva.
Resposta	SVG (padrão) ou JSON com o payload e o SVG juntos.
Tamanho	De 100 a 5000 px. Em SVG o valor só define os atributos; o desenho é vetorial.
Segurança de destino	A mesma checagem do editor: sem esquema estranho, sem credencial na URL, sem IP literal, sem host interno.
Limite	Header X-RateLimit-Limit em toda resposta. Estourou, vem 429 com o teto informado.

Limites e preço

O limite é por chave, e por minuto.

Plano	Por minuto	Observação
Free	10/min · 10 por dia · 30 por mês	Ideal para experimentar e prototipar.
Pro	60	Para produto em operação.
Business	300	Para volume e times.

Acima da franquia do plano, o excedente sai por mil chamadas. US$ 2 / 1.000. Com teto de gasto padrão, para uma integração com defeito não virar fatura surpresa. US$ 50.

Ver planos

Sobre a chave

Guardada com hash

Mostrada uma vez na criação. Perdeu, revogue e gere outra — recuperar não é possível, de propósito.

Revogação imediata

Revogou, a chave para de valer na chamada seguinte. Uma chave por integração faz derrubar uma não derrubar as outras.

Só do servidor

Chave em JavaScript de navegador, app mobile ou repositório público é chave pública. Guarde em variável de ambiente.

Sem cache compartilhado

As respostas vão com no-store: o conteúdo pode ser de um usuário específico. Se precisar de cache, faça do seu lado.

Comece com uma chave

A referência completa, com todos os parâmetros e códigos de erro, está na documentação. Há também um playground para testar sem escrever código.

Abrir o console Ler a documentação