Organizar códigos QR automaticamente: etiquetas por CLI, API e assistente

Porque é que a ordem conta com muitos códigos QR

Quem quer organizar códigos QR costuma pensar nisso tarde demais: quando a lista já é longa e ninguém sabe que código QR está colado em que cartaz. As etiquetas são palavras-chave que associas aos códigos QR, por exemplo local, campanha ou cliente. O Same-QR permite até 200 etiquetas por conta e até 20 por código QR. Depois, filtras no painel, analisas grupos e dás ordens claras a um assistente.

Passo 1: dar nomes com sentido às etiquetas

• Uma dimensão por etiqueta: “Filiale Graz” e “Plakat” em vez de “Graz Plakate”.
• A mesma grafia para todos, também para scripts e assistentes.
• Campanhas com período: “Herbst 2026” em vez de apenas “Herbst”.
• Melhor poucas etiquetas claras do que muitas que se sobrepõem.

Passo 2: criar etiquetas

Crias as etiquetas no painel ou pedes a um assistente com o Same-QR como conector: “Cria as etiquetas Filiale Graz, Filiale Linz e Plakat.” Pela API REST, faz-se com um pedido POST a /api/v1/labels. Os identificadores de todas as etiquetas mostra-os a linha de comandos:

sameqr labels list

Passo 3: atribuir etiquetas

Ao criar, associas logo as etiquetas; nos códigos QR existentes, “--label” substitui a lista inteira:

sameqr qr create --name "Graz Tisch 4" --url https://example.com/karte --label <label-graz>
sameqr qr update <id> --label <label-graz> --label <label-plakat>

Pela API, envias com um pedido PATCH a /api/v1/qr/<id> o campo labels com todos os identificadores que o código QR deve ter.

Passo 4: arrumar com um assistente

Para coleções já existentes, um assistente é ideal, porque consegue ler nomes e destinos e atribuí-los com sentido:

• “Vê todos os códigos QR e sugere-me etiquetas por local. Ainda não alteres nada.”
• “Atribui a etiqueta Filiale Graz a todos os códigos QR cujo nome começa por Graz.”
• “Que códigos QR ainda não têm nenhuma etiqueta?”

Nas alterações maiores, pede primeiro que te mostrem a lista. Se uma etiqueta for apagada, os códigos QR mantêm-se e perdem apenas a etiqueta.

Projetos para clientes

Nos planos pagos existe um nível acima das etiquetas: os projetos de clientes. Um código QR pertence no máximo a um projeto, as etiquetas valem em todos os projetos. Assim, separas bem os clientes e, dentro de cada cliente, organizas ainda por local ou campanha. “sameqr projekte list” mostra os identificadores, “--projekt” ao criar faz a atribuição.

Conclusão: porquê o Same-QR

O Same-QR dá-te uma ordem que cresce contigo: 100 etiquetas, projetos de clientes nos planos pagos e acesso a tudo isto a partir do painel, da CLI, da API e do assistente. Assim, voltas a encontrar cada código QR, mesmo que sejam centenas.

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

Perguntas frequentes