Kody QR we wdrożeniu: automatyczna zmiana celów po wydaniu

Wydrukowane kody QR i nowe adresy

Przy wydaniu strony się przenoszą: z /sommerkarte robi się /karte, z /produkt-a robi się /produkte/a. Na stronie łapiesz to przekierowaniami. Wydrukowane kody QR nadal jednak wskazują stary adres, a łańcuchy przekierowań z każdym wydaniem robią się dłuższe. W dynamicznych kodach QR od Same-QR zamiast tego przestawiasz cel bezpośrednio na nowy adres.

Krok 1: przypisanie w repozytorium

Zapisz, który kod QR ma dokąd prowadzić, na przykład w pliku qr-ziele.csv obok swojego kodu QR. Identyfikatory pobierzesz jednorazowo poleceniem „sameqr qr list”:

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

Krok 2: klucz dla pipeline'u

W panelu w sekcji Konto, „Dostęp dla CLI, skryptów i agentów”, załóż osobny klucz „pełny” tylko dla wdrożenia, bo zmiany celów wymagają tego poziomu, z odpowiednim czasem ważności. Zapisz go jako tajną zmienną SAMEQR_API_KEY w swoim CI. CLI odczytuje go stamtąd, nie zapisując go.

Krok 3: przestawienie po wydaniu

Po udanym wdrożeniu uruchamia się krótki 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

Skrypt najpierw sprawdza, czy nowy adres odpowiada, i dopiero potem przestawia cel. W razie błędu przerywa działanie. Ponieważ w CI nikt nie siedzi przy terminalu, zmianę potwierdza --yes. CLI odczytuje przy tym wcześniej aktualny stan każdego kodu QR. Ważne: przez API możliwych jest najwyżej 10 zmian celu na godzinę i 30 na dobę. Ten krok nadaje się więc do garstki kodów QR na wydanie. Przy większych zmianach użyj panelu lub harmonogramu.

Harmonogram jako alternatywa

Jeśli moment jest znany wcześniej, na przykład premiera w poniedziałek o godzinie 9, od taryfy Gastro Pro lub Marketing Pro dostępny jest harmonogram: kod QR od określonej daty lub o wybranych porach prowadzi na inny cel, w strefie czasowej kodu QR, z maksymalnie 10 regułami. Wtedy nie potrzebujesz żadnego kroku we wdrożeniu.

Cofanie, gdy coś pójdzie nie tak

Zachowaj stare przypisanie. Wycofanie to wtedy ten sam krok z poprzednim plikiem. Dodatkowo Same-QR co noc sprawdza wszystkie cele i wysyła e-mail, jeśli któryś jest niedostępny.

Podsumowanie: dlaczego Same-QR

Dzięki Same-QR wydrukowane kody QR stają się częścią twojego wdrożenia: CLI pasujące do każdego pipeline'u, ochrona przed równoczesnym nadpisywaniem, harmonogram od taryfy Gastro Pro lub Marketing Pro i nocne sprawdzanie celów jako siatka bezpieczeństwa. Żaden kod QR po wydaniu nie prowadzi w pustkę.

Zacznij od razu: zarejestruj się za darmo na sameqr.com, 20 dynamicznych kodów QR jest na stałe bezpłatnych. API, CLI i serwer MCP są w każdej taryfie, a dokumentacja jest na sameqr.com/entwickler.

Najczęściej zadawane pytania