Códigos QR no deployment: mudar os destinos automaticamente depois de um release

Códigos QR impressos e novos endereços

Num release, as páginas mudam de sítio: /sommerkarte passa a /karte e /produkt-a passa a /produkte/a. No site resolves isso com redirecionamentos. Mas os códigos QR impressos continuam a apontar para o endereço antigo, e as cadeias de redirecionamentos ficam mais compridas a cada release. Nos códigos QR dinâmicos do Same-QR, em vez disso, mudas o destino diretamente para o novo endereço.

Passo 1: a correspondência no repositório

Regista qual código QR deve apontar para onde, por exemplo em qr-ziele.csv, junto ao teu código QR. Os identificadores obténs uma única vez com “sameqr qr list”:

speisekarte-lx3k9a1b2;https://example.com/karte
flyer-herbst-q8w7e6r5;https://example.com/aktion/herbst

Passo 2: chave para a pipeline

No painel, em Conta, “Acesso para CLI, scripts e agentes”, cria uma chave própria “total” só para o deployment, porque as alterações de destino exigem este nível, com uma validade adequada. Guarda-a como variável secreta SAMEQR_API_KEY na tua CI. A CLI lê-a de lá, sem a guardar.

Passo 3: mudar depois do release

Depois de um deployment bem-sucedido, corre um passo curto:

npm install -g sameqr
while IFS=";" read -r id url; do
  curl -fsS -o /dev/null "$url" || { echo "Ziel nicht erreichbar: $url"; exit 1; }
  sameqr qr update "$id" --url "$url" --yes --json || exit 1
done < qr-ziele.csv

O script verifica primeiro se o novo endereço responde e só depois muda o destino. Se houver um erro, interrompe. Como na CI ninguém está ao terminal, --yes confirma a alteração. Para isso, a CLI lê antes o estado atual de cada código QR. Importante: através da API são permitidas no máximo 10 alterações de destino por hora e 30 por dia. Por isso, este passo serve para um punhado de códigos QR por release. Para mudanças maiores, usa o painel ou o controlo por horário.

Controlo por horário como alternativa

Se a hora está definida de antemão, por exemplo um lançamento na segunda-feira às 9 horas, existe o controlo por horário a partir do Gastro Pro ou do Marketing Pro: um código QR encaminha para outro destino a partir de uma data ou em determinados horários, no fuso horário do código QR, com até 10 regras. Assim, não precisas de nenhum passo no deployment.

Voltar atrás se algo correr mal

Guarda a correspondência antiga. Um rollback é então o mesmo passo com o ficheiro anterior. Além disso, o Same-QR verifica todos os destinos todas as noites e envia um e-mail se algum não estiver acessível.

Conclusão: porquê o Same-QR

Com o Same-QR, os códigos QR impressos passam a fazer parte do teu deployment: uma CLI que encaixa em qualquer pipeline, proteção contra sobrescritas em paralelo, controlo por horário a partir do Gastro Pro ou do Marketing Pro e uma verificação noturna dos destinos como rede de segurança. Nenhum código QR leva a lado nenhum depois de um release.

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