QR code nel deployment: modificare automaticamente le destinazioni dopo un rilascio

Codici stampati e nuovi indirizzi

In caso di rilascio, le pagine vengono spostate: da /sommerkarte a /karte, da /produkt-a a /produkte/a. Sul sito web gestisci questo spostamento con reindirizzamenti. I codici QR stampati, tuttavia, continuano a puntare all'indirizzo vecchio e le catene di reindirizzamento si allungano ad ogni rilascio. Con i codici dinamici di Same-QR, invece, modifichi direttamente la destinazione verso il nuovo indirizzo.

Passaggio 1: Mappatura nel repository

Conserva la mappatura di quale codice deve puntare dove, ad esempio in qr-ziele.csv accanto al codice. Le chiavi vengono recuperate una tantum con „sameqr qr list“:

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

Passaggio 2: Chiave per la pipeline

Nella dashboard, sotto Account, «Accesso per CLI, script e agenti», crea una chiave «completo» solo per il deployment, perché i cambi di destinazione richiedono questo livello, con una durata adeguata. La salvi come variabile segreta SAMEQR_API_KEY nella tua CI. La CLI la legge da lì senza salvarla.

Passaggio 3: Modifica dopo il rilascio

Dopo un deployment riuscito, viene eseguito un breve passaggio:

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

Lo script verifica innanzitutto se il nuovo indirizzo risponde e procede con la modifica solo in tal caso. In caso di errore, l'esecuzione viene interrotta. Poiché in CI nessuno è presente al terminale, l'opzione --yes conferma la modifica. La CLI legge per tale scopo lo stato corrente di ciascun codice. Importante: tramite l'API sono consentite al massimo 10 modifiche alla destinazione all'ora e 30 al giorno. Il passaggio è quindi adatto per un piccolo numero di codici per release. Per modifiche più estese, utilizzare il dashboard o il controllo temporizzato.

Controllo temporale come alternativa

Se il momento è stabilito in anticipo, ad esempio un lancio lunedì alle 9, dal piano Pro c’è la programmazione oraria: un codice inoltra da una certa data o in certi orari a un’altra destinazione, nel fuso orario del codice, con fino a 10 regole. Allora non serve alcun passaggio nel deployment.

Indietro se qualcosa va storto

Conserva la vecchia assegnazione. Un rollback è quindi lo stesso passaggio con il file precedente. Inoltre, Same-QR controlla ogni notte tutte le destinazioni e invia una mail se una non è raggiungibile.

Conclusione: perché Same-QR

Con Same-QR i codici stampati diventano parte del tuo deployment: una CLI che si adatta a qualsiasi pipeline, protezione contro la sovrascrittura parallela, pianificazione temporale a partire dal piano Pro e un controllo notturno delle destinazioni come rete di sicurezza. Nessun codice porta a vuoto dopo un rilascio.

Inizi subito: registrati gratuitamente su sameqr.com, due codici QR dinamici sono gratuiti per sempre. API, CLI e server MCP sono inclusi in ogni piano, la documentazione è su sameqr.com/entwickler.

Domande frequenti