QR-Codes im Deployment: Ziele nach einem Release automatisch umstellen

Gedruckte Codes und neue Adressen

Bei einem Release ziehen Seiten um: aus /sommerkarte wird /karte, aus /produkt-a wird /produkte/a. Auf der Website fängst du das mit Weiterleitungen ab. Gedruckte QR-Codes zeigen aber weiter auf die alte Adresse, und Weiterleitungsketten werden mit jedem Release länger. Bei dynamischen Codes von Same-QR stellst du stattdessen das Ziel direkt auf die neue Adresse um.

Schritt 1: Zuordnung im Repository

Halte fest, welcher Code wohin zeigen soll, zum Beispiel in qr-ziele.csv neben deinem Code. Die Kennungen holst du einmalig mit „sameqr qr list“:

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

Schritt 2: Schlüssel für die Pipeline

Leg im Dashboard unter Konto, „Zugang für CLI, Skripte und Agenten“, einen eigenen Schlüssel „voll“ nur für das Deployment an, denn Zieländerungen brauchen diese Stufe, mit passender Laufzeit. Hinterlege ihn als geheime Variable SAMEQR_API_KEY in deiner CI. Die CLI liest ihn von dort, ohne ihn zu speichern.

Schritt 3: Umstellen nach dem Release

Nach erfolgreichem Deployment läuft ein kurzer Schritt:

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

Das Skript prüft zuerst, ob die neue Adresse antwortet, und stellt erst dann um. Bei einem Fehler bricht es ab. Weil in der CI niemand am Terminal sitzt, bestätigt --yes die Änderung. Die CLI liest dafür vorher den aktuellen Stand jedes Codes. Wichtig: Über die API gehen höchstens 10 Zieländerungen je Stunde und 30 je Tag. Der Schritt passt also für eine Handvoll Codes je Release. Für größere Umstellungen nimm das Dashboard oder die Zeitsteuerung.

Zeitsteuerung als Alternative

Steht der Zeitpunkt vorher fest, etwa ein Launch am Montag um 9 Uhr, gibt es ab dem Tarif Pro die Zeitsteuerung: Ein Code leitet ab einem Datum oder zu bestimmten Zeiten auf ein anderes Ziel, in der Zeitzone des Codes, mit bis zu 10 Regeln. Dann braucht es gar keinen Schritt im Deployment.

Zurück, wenn etwas schiefgeht

Bewahre die alte Zuordnung auf. Ein Rollback ist dann derselbe Schritt mit der vorherigen Datei. Zusätzlich prüft Same-QR jede Nacht alle Ziele und schickt eine Mail, wenn eines nicht erreichbar ist.

Fazit: Warum Same-QR

Mit Same-QR werden gedruckte Codes Teil deines Deployments: eine CLI, die in jede Pipeline passt, Schutz vor parallelem Überschreiben, Zeitsteuerung ab Pro und eine nächtliche Zielprüfung als Netz. Kein Code führt nach einem Release ins Leere.

Leg gleich los: Registriere dich kostenlos auf sameqr.com, zwei dynamische QR-Codes sind dauerhaft gratis. API, CLI und MCP-Server gibt es in jedem Tarif, die Dokumentation steht auf sameqr.com/entwickler.

Häufig gestellte Fragen