Estatísticas de códigos QR pela API: levar as leituras para relatórios próprios

O que é contado

O Same-QR conta, para cada código QR dinâmico, quantas vezes foi lido. Não é criado nenhum perfil de quem lê. A contagem torna-se útil com uma boa divisão: um código QR por local, suporte publicitário ou loja. A estatística de um código QR inclui o total de leituras, a data de criação, quantas vezes o destino foi alterado e se o código QR está inativo, por exemplo porque a conta ultrapassa o limite do seu plano.

Passo 1: Criar uma chave de leitura

Para relatórios nunca precisas de direitos de escrita. Cria no painel, em Conta, “Acesso para CLI, scripts e agentes”, uma chave “só leitura” e dá-lhe um nome conforme a finalidade, por exemplo “Relatório mensal”. Ela pode consultar números, mas não alterar nem apagar nada. Isto é importante sobretudo para tarefas que correm sem supervisão.

Passo 2: Obter os números

Pela API REST, a lista de todos os códigos QR já traz o número de leituras de cada código QR, e a estatística de um código QR individual consultas em separado:

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr/<id>/stats

Com a linha de comandos é mais curto:

sameqr qr list --json > scans-$(date +%Y-%m).json
sameqr qr stats <id>

Passo 3: Montar o relatório

Como as leituras são totais, guardas todos os meses um estado e comparas com o mês anterior. A diferença é o número de leituras no mês. Relatórios típicos:

• Relatório mensal para um cliente de agência com todos os códigos QR do projeto do cliente.
• Comparação de várias lojas, quando cada loja tem códigos QR próprios e uma etiqueta própria.
• Análise de uma campanha de cartazes por locais.

Também se faz sem programa próprio: um assistente como o ChatGPT ou o Claude com o Same-QR como conector responde a “Quais foram os cinco códigos QR mais lidos?” diretamente na conversa.

Limites dos números

• Uma leitura não significa que alguém leu a página.
• Poucas leituras podem dever-se ao local, por exemplo a má iluminação ou a um código QR demasiado pequeno.
• Para o comportamento no site precisas da análise web. As campanhas com parâmetros utm ligam as duas.

Conclusão: porquê o Same-QR

O Same-QR conta com rigor e poupa dados, e chegas aos números como te convém: no painel, pela API, pela CLI ou na conversa com um assistente. Basta uma chave de leitura, e a API está incluída em todos os planos.

Começa já: regista-te gratuitamente em sameqr.com, 20 códigos QR dinâmicos são gratuitos para sempre. API, CLI e servidor MCP existem em todos os planos, a documentação está em sameqr.com/entwickler.

Perguntas frequentes