QR kódy v deploymentu: automatická změna cílů po releasu

Vytištěné QR kódy a nové adresy

Při releasu se stránky stěhují: z /sommerkarte se stane /karte, z /produkt-a se stane /produkte/a. Na webu to zachytíš přesměrováními. Vytištěné QR kódy ale dál ukazují na starou adresu a řetězce přesměrování se s každým releasem prodlužují. U dynamických QR kódů Same-QR místo toho přepneš cíl rovnou na novou adresu.

Krok 1: Přiřazení v repozitáři

Zapiš si, kam má který QR kód vést, například do souboru qr-ziele.csv vedle svého QR kódu. Identifikátory si jednorázově vyžádáš příkazem „sameqr qr list“:

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

Krok 2: Klíč pro pipeline

V dashboardu v části Účet, „Přístup pro CLI, skripty a agenty“, vytvoř samostatný klíč „plný“ jen pro deployment, protože změny cílů vyžadují tuto úroveň, s odpovídající platností. Ulož ho jako tajnou proměnnou SAMEQR_API_KEY ve svém CI. CLI ho odtud čte, aniž by ho ukládalo.

Krok 3: Přepnutí po releasu

Po úspěšném deploymentu proběhne krátký krok:

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

Skript nejdřív ověří, zda nová adresa odpovídá, a teprve potom cíl přepne. Při chybě se zastaví. Protože v CI nikdo nesedí u terminálu, změnu potvrzuje --yes. CLI přitom předem načte aktuální stav každého QR kódu. Důležité: přes API lze provést nejvýše 10 změn cíle za hodinu a 30 za den. Tento krok tedy sedí na hrstku QR kódů na jeden release. Pro větší přechody použij dashboard nebo časové řízení.

Časové řízení jako alternativa

Pokud je čas známý předem, například launch v pondělí v 9 hodin, je od tarifu Gastro Pro, respektive Marketing Pro k dispozici časové řízení: QR kód od určitého data nebo v určitých časech přesměruje na jiný cíl, v časovém pásmu QR kódu, s až 10 pravidly. Pak v deploymentu nepotřebuješ žádný krok.

Zpět, když se něco pokazí

Uchovej si staré přiřazení. Rollback je pak stejný krok s předchozím souborem. Same-QR navíc každou noc zkontroluje všechny cíle a pošle e-mail, pokud některý není dostupný.

Závěr: Proč Same-QR

Se Same-QR se vytištěné QR kódy stanou součástí tvého deploymentu: CLI, které zapadne do každé pipeline, ochrana před souběžným přepsáním, časové řízení od tarifu Gastro Pro, respektive Marketing Pro, a noční kontrola cílů jako záchranná síť. Žádný QR kód po releasu nevede do prázdna.

Začni hned: zaregistruj se zdarma na sameqr.com, 20 dynamických QR kódů je trvale zdarma. API, CLI a server MCP jsou v každém tarifu, dokumentace je na sameqr.com/entwickler.

Často kladené otázky