Coduri QR în deployment: schimbă automat destinațiile după un release

Coduri QR tipărite și adrese noi

La un release se mută pagini: /sommerkarte devine /karte, /produkt-a devine /produkte/a. Pe site prinzi asta cu redirecționări. Codurile QR tipărite însă trimit în continuare la adresa veche, iar lanțurile de redirecționări se lungesc cu fiecare release. La codurile QR dinamice de la Same-QR, în schimb, setezi destinația direct pe adresa nouă.

Pasul 1: Corespondența în repository

Notează ce cod QR trebuie să trimită unde, de exemplu în qr-ziele.csv, lângă codul tău QR. Identificatorii îi iei o singură dată cu „sameqr qr list”:

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

Pasul 2: Cheia pentru pipeline

În dashboard, la Cont, „Acces pentru CLI, scripturi și agenți”, creează o cheie proprie „completă”, doar pentru deployment, pentru că schimbarea destinațiilor are nevoie de acest nivel, cu o valabilitate potrivită. Salvează-o ca variabilă secretă SAMEQR_API_KEY în CI-ul tău. CLI-ul o citește de acolo, fără să o stocheze.

Pasul 3: Schimbarea după release

După un deployment reușit rulează un pas scurt:

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

Scriptul verifică mai întâi dacă adresa nouă răspunde și abia apoi face schimbarea. În caz de eroare se oprește. Pentru că în CI nimeni nu stă la terminal, --yes confirmă modificarea. CLI-ul citește înainte starea actuală a fiecărui cod QR. Important: prin API se pot face cel mult 10 schimbări de destinație pe oră și 30 pe zi. Pasul se potrivește deci pentru un pumn de coduri QR la fiecare release. Pentru schimbări mai mari folosește dashboard-ul sau programarea în timp.

Programarea în timp ca alternativă

Dacă momentul e stabilit dinainte, de exemplu o lansare luni la ora 9, de la Gastro Pro, respectiv Marketing Pro, există programarea în timp: un cod QR trimite de la o dată sau la anumite ore către o altă destinație, în fusul orar al codului QR, cu până la 10 reguli. Atunci nu mai ai nevoie deloc de un pas în deployment.

Înapoi, dacă ceva merge prost

Păstrează corespondența veche. Un rollback este atunci același pas, cu fișierul anterior. În plus, Same-QR verifică în fiecare noapte toate destinațiile și îți trimite un e-mail dacă una nu poate fi accesată.

Concluzie: de ce Same-QR

Cu Same-QR, codurile QR tipărite devin parte din deployment-ul tău: un CLI care se potrivește în orice pipeline, protecție împotriva suprascrierii în paralel, programare în timp de la Gastro Pro, respectiv Marketing Pro, și o verificare nocturnă a destinațiilor ca plasă de siguranță. Niciun cod QR nu duce în gol după un release.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite pentru totdeauna. API, CLI și server MCP există în fiecare tarif, iar documentația se află la sameqr.com/entwickler.

Întrebări frecvente