Código QR na linha de comandos: instalar e usar a CLI sameqr

Porquê a linha de comandos

Uma CLI (Command Line Interface) é um programa que usas através de comandos de texto no terminal. Um comando pode ser repetido, escrito num script, encadeado com outras ferramentas e executado por um agente de programação. A CLI sameqr leva o Same-QR precisamente para esse sítio. Não tem mais dependências e só precisa do Node.js a partir da versão 18.

Passo 1: instalar

A CLI chega através do npm, o gestor de pacotes do Node.js:

npm install -g sameqr
sameqr --version

Passo 2: criar a chave de API

No painel, em Conta, encontras a secção «Acesso para CLI, scripts e agentes». Cria lá uma chave. Para começar, basta «leitura + escrita»: criar, alterar nomes e textos. Quem também quiser alterar destinos de códigos QR existentes, pôr páginas offline ou apagá-las escolhe «total». Ela começa por sqr_live_ e só é mostrada uma vez. Guarda-a logo no teu gestor de palavras-passe.

Passo 3: iniciar sessão

A chave nunca é passada como argumento, senão ficaria no histórico da shell. «sameqr login» pede-a de forma oculta, verifica-a e guarda-a só legível para ti em ~/.config/sameqr/config.json. Em alternativa, defines a variável de ambiente SAMEQR_API_KEY, que tem sempre prioridade.

sameqr login
sameqr whoami

«sameqr whoami» mostra a tua conta, o plano e quantos códigos QR podes criar.

Passo 4: criar o primeiro código QR

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

Com --slug defines, ao criar, uma ligação curta própria, com --label juntas etiquetas. Os seus identificadores são mostrados por «sameqr labels list». Alterar o destino, pôr offline e apagar exigem uma chave «total». A CLI pergunta então no terminal; em scripts sem terminal, só funciona com um --yes expresso. Através da API, são possíveis no máximo 10 dessas alterações por hora e 30 por dia.

Passo 5: páginas de convidados e ementas

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

«seite create» devolve o endereço da nova página, no exemplo menu/gasthof-zum-loewen. Precisas dele para os comandos seguintes. A página nasce como rascunho. «karte import» lê as fotos por IA e junta à página os grupos reconhecidos, sem substituir nada. Revê o rascunho antes de publicares. Para publicar, os dados do responsável têm de estar preenchidos. O último comando cria um código QR que aponta diretamente para a página. Outros modelos: preisliste, zeiten, links, aktion, weingut, etikett e kontakt.

Passo 6: em scripts com --json

Se juntares --json a um comando, a resposta vem em JSON. Os erros também chegam então como JSON na saída de erros, e o código de retorno revela o tipo: 3 significa sem sessão iniciada, 4 direitos em falta, 2 uma entrada errada. Assim, um script reage de forma direcionada, em vez de interpretar texto.

sameqr qr list --json

Conclusão: porquê o Same-QR

A CLI sameqr leva para o terminal todo o âmbito de funções do Same-QR: códigos QR, estatísticas, páginas de convidados, ementas a partir de fotos, etiquetas e projetos. É leve, trata a tua chave com cuidado e fala JSON para scripts e agentes de programação. E funciona 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, e a documentação está em sameqr.com/entwickler.

Perguntas frequentes