QR kodovi u deploymentu: automatsko preusmeravanje odredišta posle izdanja

Odštampani QR kodovi i nove adrese

Pri izdanju se stranice sele: /sommerkarte postaje /karte, a /produkt-a postaje /produkte/a. Na veb stranici to rešavaš preusmeravanjima. Odštampani QR kodovi, međutim, i dalje pokazuju na staru adresu, a lanci preusmeravanja sa svakim izdanjem postaju duži. Kod dinamičkih QR kodova Same-QR umesto toga odredište direktno preusmeravaš na novu adresu.

Korak 1: Dodela u repozitorijumu

Zabeleži koji QR kod treba da vodi kuda, na primer u qr-ziele.csv pored svog QR koda. Identifikatore jednokratno preuzimaš sa „sameqr qr list“:

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

Korak 2: Ključ za pipeline

Na kontrolnoj tabli pod Nalog, „Pristup za CLI, skripte i agente“, napravi poseban ključ „potpuno“ samo za deployment, jer promene odredišta zahtevaju taj nivo, sa odgovarajućim rokom važenja. Sačuvaj ga kao tajnu promenljivu SAMEQR_API_KEY u svom CI-ju. CLI ga odatle čita, bez čuvanja.

Korak 3: Preusmeri posle izdanja

Posle uspešnog deploymenta pokreće se kratak korak:

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

Skripta prvo proverava javlja li se nova adresa, pa tek onda preusmerava. Pri grešci prekida rad. Pošto u CI-ju niko ne sedi za terminalom, --yes potvrđuje promenu. CLI za to prethodno čita trenutno stanje svakog QR koda. Važno: preko API-ja moguće je najviše 10 promena odredišta na sat i 30 na dan. Korak je dakle pogodan za šačicu QR kodova po izdanju. Za veća preusmeravanja koristi kontrolnu tablu ili vremensko upravljanje.

Vremensko upravljanje kao alternativa

Ako je vreme unapred poznato, na primer lansiranje u ponedeljak u 9 sati, od tarife Gastro Pro odnosno Marketing Pro postoji vremensko upravljanje: QR kod od nekog datuma ili u određeno vreme vodi na drugo odredište, u vremenskoj zoni QR koda, sa do 10 pravila. Tada ne treba nikakav korak u deploymentu.

Nazad, ako nešto pođe po zlu

Sačuvaj staru dodelu. Povratak je tada isti korak sa prethodnom datotekom. Pored toga, Same-QR svake noći proverava sva odredišta i šalje mejl ako neko nije dostupno.

Zaključak: zašto Same-QR

Sa Same-QR odštampani QR kodovi postaju deo tvog deploymenta: CLI koji staje u svaki pipeline, zaštita od istovremenog prepisivanja, vremensko upravljanje od tarife Gastro Pro odnosno Marketing Pro i noćna provera odredišta kao mreža sigurnosti. Nijedan QR kod posle izdanja ne vodi u prazno.

Kreni odmah: registruj se besplatno na sameqr.com, 20 dinamičkih QR kodova trajno je besplatno. API, CLI i MCP server dostupni su u svakoj tarifi, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja