API de códigos QR: como integrar a geração na sua web ou app
Guia com exemplos curl para criar, gerenciar e baixar QR dinâmicos via API REST
A API REST do codigo-qr.es permite gerar, atualizar e analisar códigos QR diretamente da sua aplicação, sem usar o painel. Você pode automatizar a criação de QR para notas fiscais, cardápios digitais ou ingressos, e mudar o destino de um QR dinâmico em produção sem tocar no código impresso. O endpoint público funciona sem cadastro. A API completa, com CRUD e estatísticas, requer plano Pro.
Quais endpoints tem a API de código QR?
A API REST tem oito endpoints: geração pública sem auth, e sete Pro para criar, listar, atualizar, deletar, baixar e analisar códigos QR.
A API do codigo-qr.es tem dois tiers.
Endpoint público (sem conta):
`POST /api/v1/qr/render` gera um QR estático e retorna a imagem em base64. Limite: 50 requisições por dia por IP.
Endpoints Pro (requerem API key):
| Método | Rota | Finalidade | |--------|------|------------| | `GET` | `/api/v1/qr` | Listar todos os seus QR | | `POST` | `/api/v1/qr` | Criar QR estático ou dinâmico | | `GET` | `/api/v1/qr/{id}` | Detalhes de um QR | | `PATCH` | `/api/v1/qr/{id}` | Alterar destino ou nome | | `DELETE` | `/api/v1/qr/{id}` | Excluir um QR | | `GET` | `/api/v1/qr/{id}/image` | Baixar imagem PNG ou SVG | | `GET` | `/api/v1/qr/{id}/stats` | Estatísticas de escaneamentos |
Todas as respostas Pro seguem `{ "data": {...}, "error": null }`.
Como obter uma API key de QR?
A API key é gerada em /panel/conta com um clique. Só está disponível com plano Pro ativo e pode ser revogada do mesmo painel.
Passo 1. Crie uma conta em codigo-qr.es.
Passo 2. Ative o plano Pro. A API completa é exclusiva Pro a €5,99/mês.
Passo 3. Vá para /panel/conta e clique em «Gerar API key». O token é exibido apenas uma vez. Salve-o em um gerenciador de senhas.
Adicione este header a cada requisição:
```bash curl https://codigo-qr.es/api/v1/qr \ -H "Authorization: Bearer cqr_seu_token" ```
Como gerar um código QR via API sem cadastro?
O endpoint /api/v1/qr/render gera QR PNG ou SVG sem conta nem API key, com limite de 50 requisições por dia por IP.
```bash curl -X POST https://codigo-qr.es/api/v1/qr/render \ -H "Content-Type: application/json" \ -d '{"value":"https://seudominio.com","format":"png","size":512}' ```
Parâmetros: `value` (obrigatório), `format` (png ou svg, padrão png), `size` (256, 512 ou 1024, padrão 512).
Se exceder 50 requisições por dia, recebe `429 RATE_LIMITED` com o header `Retry-After`.
Como criar e atualizar QR dinâmicos via API?
POST /api/v1/qr cria o QR dinâmico e retorna seu ID. PATCH /api/v1/qr/{id} muda o destino sem regenerar nem reimprimir o código.
Criar um QR dinâmico:
```bash curl -X POST https://codigo-qr.es/api/v1/qr \ -H "Authorization: Bearer cqr_seu_token" \ -H "Content-Type: application/json" \ -d '{ "label": "Cardápio maio", "type": "url", "value": "https://seurestaurante.com/cardapio-maio", "is_dynamic": true, "tracking_mode": "redirect" }' ```
Mudar o destino sem reimprimir:
```bash curl -X PATCH https://codigo-qr.es/api/v1/qr/{id} \ -H "Authorization: Bearer cqr_seu_token" \ -H "Content-Type: application/json" \ -d '{"destination": "https://seurestaurante.com/cardapio-junho"}' ```
Para que se usa a API de QR num negócio?
A API de QR é útil quando você precisa gerar ou atualizar mais de dez códigos por mês: notas fiscais, cardápios digitais ou sistemas de venda de ingressos.
E-commerce: O ERP gera um QR por nota fiscal com o link de rastreamento. Se a URL mudar, `PATCH` atualiza o destino sem reimprimir nada.
Restaurantes: O PDV cria um QR por mesa ao abrir o turno. O chef atualiza o cardápio no CMS; o QR sempre redireciona para a versão atual.
Eventos: O sistema de ingressos gera um QR único por ingresso. Na entrada, o scanner verifica via API.
Logística: Cada pacote tem um QR que aponta para sua página de rastreamento. Os escaneamentos ficam em `GET /api/v1/qr/{id}/stats`.
Quantas requisições a API de QR permite?
O endpoint público aceita 50 requisições por dia por IP. Os endpoints Pro permitem 60 requisições por minuto por usuário com API key.
Tier pública: 50 por dia por IP, sem cadastro.
Tier Pro: 60 por minuto por usuário, sem limite diário total.
Ao exceder o limite, a API retorna `429` com os headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `Retry-After`.
Veja a documentação completa para todos os parâmetros.
§CODIGO-QR.ES / PRO
Comece a integrar a API de QR hoje
Crie sua conta, ative o plano Pro e gere sua primeira API key em menos de 2 minutos.
Preguntas frecuentes
- A API de códigos QR é gratuita?
- O endpoint público é gratuito, limitado a 50 requisições por dia por IP. A API completa, com API key, CRUD, imagem e estatísticas, requer plano Pro a €5,99/mês.
- Os QR gerados via API são lidos por qualquer leitor?
- Sim. Os códigos seguem o padrão ISO/IEC 18004. Funcionam com a câmera do celular e com qualquer app de leitura QR.
- Posso mudar o destino de um QR dinâmico via API sem reimprimir?
- Sim. PATCH /api/v1/qr/{id} atualiza a URL de destino a qualquer momento. O QR impresso fica igual; só muda o destino.
- O token da API é seguro?
- Apenas o hash SHA-256 é armazenado, nunca o token em si. Exibido uma vez ao gerar. Você pode revogar em /panel/conta a qualquer momento.
Jose Flores
Fundador de codigo-qr.es · codigo-qr.es
Jose Flores es fundador de codigo-qr.es, herramienta de generación de QR dinámicos y códigos de barras creada en Barcelona en 2026. Especializado en soluciones digitales para pequeños negocios, desarrolla herramientas que permiten a restaurantes, comercios y profesionales digitalizar su comunicación sin infraestructura técnica propia.
Más artículos