QR-codes in je deployment: doelen na een release automatisch omzetten

Gedrukte QR-codes en nieuwe adressen

Bij een release verhuizen pagina's: van /sommerkarte wordt /karte, van /produkt-a wordt /produkte/a. Op de website vang je dat op met redirects. Gedrukte QR-codes wijzen echter nog steeds naar het oude adres, en redirectketens worden met elke release langer. Bij dynamische QR-codes van Same-QR zet je in plaats daarvan het doel direct om naar het nieuwe adres.

Stap 1: de koppeling in de repository

Leg vast welke QR-code waarheen moet wijzen, bijvoorbeeld in qr-ziele.csv naast je QR-code. De ID's haal je eenmalig op met “sameqr qr list”:

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

Stap 2: sleutel voor de pipeline

Maak in het dashboard onder Account, “Toegang voor CLI, scripts en agents”, een aparte sleutel “volledig” aan, alleen voor het deployment, want doelwijzigingen vereisen dit niveau, met een passende geldigheidsduur. Sla hem op als geheime variabele SAMEQR_API_KEY in je CI. De CLI leest hem daar uit, zonder hem op te slaan.

Stap 3: omzetten na de release

Na een geslaagd deployment draait een korte stap:

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

Het script controleert eerst of het nieuwe adres reageert en zet pas daarna om. Bij een fout stopt het. Omdat er in de CI niemand achter de terminal zit, bevestigt --yes de wijziging. De CLI leest daarvoor eerst de huidige status van elke QR-code uit. Belangrijk: via de API kun je maximaal 10 doelwijzigingen per uur en 30 per dag doorvoeren. Deze stap past dus bij een handvol QR-codes per release. Gebruik voor grotere omzettingen het dashboard of de tijdsturing.

Tijdsturing als alternatief

Staat het tijdstip van tevoren vast, bijvoorbeeld een launch op maandag om 9 uur, dan is er vanaf Gastro Pro of Marketing Pro de tijdsturing: een QR-code leidt vanaf een bepaalde datum of op bepaalde tijden naar een ander doel, in de tijdzone van de QR-code, met maximaal 10 regels. Dan heb je helemaal geen stap in het deployment nodig.

Terug als er iets misgaat

Bewaar de oude koppeling. Een rollback is dan dezelfde stap met het vorige bestand. Bovendien controleert Same-QR elke nacht alle doelen en stuurt het een e-mail als er een niet bereikbaar is.

Conclusie: waarom Same-QR

Met Same-QR worden gedrukte QR-codes een onderdeel van je deployment: een CLI die in elke pipeline past, bescherming tegen gelijktijdig overschrijven, tijdsturing vanaf Gastro Pro of Marketing Pro en een nachtelijke doelcontrole als vangnet. Geen enkele QR-code leidt na een release nog naar het niets.

Ga meteen aan de slag: registreer je gratis op sameqr.com, 20 dynamische QR-codes zijn blijvend gratis. API, CLI en MCP-server zijn er in elk abonnement, de documentatie staat op sameqr.com/entwickler.

Veelgestelde vragen