QR kodovi u deploymentu: automatski promijeni odredišta nakon izdanja

Odštampani QR kodovi i nove adrese

Pri izdanju se stranice sele: iz /sommerkarte postaje /karte, iz /produkt-a postaje /produkte/a. Na web stranici to riješiš preusmjeravanjima. Odštampani QR kodovi, međutim, i dalje pokazuju na staru adresu, a lanci preusmjeravanja sa svakim izdanjem postaju duži. Kod dinamičkih QR kodova servisa Same-QR umjesto toga odredište direktno promijeniš na novu adresu.

Korak 1: Pridruživanje u repozitoriju

Zabilježi koji QR kod treba kamo da pokazuje, na primjer u qr-ziele.csv pored svog QR koda. Oznake jednokratno dobiješ pomoću „sameqr qr list“:

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

Korak 2: Ključ za pipeline

U dashboardu pod Račun, „Pristup za CLI, skripte i agente“, napravi poseban ključ „potpuni“ samo za deployment, jer promjene odredišta traže taj nivo, s odgovarajućim rokom trajanja. Spremi ga kao tajnu varijablu SAMEQR_API_KEY u svom CI-ju. CLI ga čita odatle, a da ga ne sprema.

Korak 3: Promjena nakon izdanja

Nakon uspješ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 provjeri odgovara li nova adresa i tek onda mijenja odredište. U slučaju greške se prekida. Pošto u CI-ju niko ne sjedi za terminalom, --yes potvrđuje promjenu. CLI prethodno pročita trenutno stanje svakog QR koda. Važno: preko API-ja je moguće najviše 10 promjena odredišta po satu i 30 dnevno. Ovaj korak je dakle prikladan za šaku QR kodova po izdanju. Za veće promjene koristi dashboard ili vremensko upravljanje.

Vremensko upravljanje kao alternativa

Ako je termin unaprijed poznat, na primjer lansiranje u ponedjeljak u 9 sati, od tarife Gastro Pro odnosno Marketing Pro postoji vremensko upravljanje: QR kod od određenog datuma ili u određeno vrijeme preusmjerava na drugo odredište, u vremenskoj zoni QR koda, s do 10 pravila. Tada ti u deploymentu uopće ne treba nikakav korak.

Nazad, ako nešto pođe po zlu

Sačuvaj staro pridruživanje. Povratak na staro stanje je tada isti korak s prethodnom datotekom. Osim toga, Same-QR svake noći provjerava sva odredišta i šalje e-poštu ako neko nije dostupno.

Zaključak: Zašto Same-QR

Uz Same-QR odštampani QR kodovi postaju dio tvog deploymenta: CLI koji staje u svaki pipeline, zaštita od paralelnog prepisivanja, vremensko upravljanje od tarife Gastro Pro odnosno Marketing Pro i noćna provjera odredišta kao sigurnosna mreža. Nijedan QR kod nakon izdanja ne vodi u prazno.

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

Često postavljana pitanja