QR Codes dans le déploiement : Rediriger automatiquement les cibles après une version

Codes QR imprimés et nouvelles adresses

Lors d'une version, les pages changent d'emplacement : /sommerkarte devient /karte, /produkt-a devient /produkte/a. Sur le site web, vous gérez cela avec des redirections. Les QR codes imprimés pointent cependant toujours vers l'ancienne adresse, et les chaînes de redirection deviennent de plus en plus longues à chaque version. Avec les codes QR dynamiques de Same-QR, vous redirigez la cible directement vers la nouvelle adresse.

Étape 1 : Association dans le dépôt

Notez quel code QR doit pointer où, par exemple dans qr-ziele.csv à côté de votre code QR. Vous obtenez les identifiants une seule fois avec « sameqr qr list » :

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

Étape 2 : Clé pour la pipeline

Dans le tableau de bord, sous Compte, « Accès pour CLI, scripts et agents », définissez une clé propre « complet » uniquement pour le déploiement, car les modifications de cible nécessitent ce niveau, avec le temps d'exécution approprié. Enregistrez-la en tant que variable secrète SAMEQR_API_KEY dans votre CI. La CLI la lit à partir de là, sans la stocker.

Étape 3 : Redirection après la version

Après un déploiement réussi, une courte étape s'exécute :

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

Le script vérifie d'abord si la nouvelle adresse répond, et ne procède au changement qu'ensuite. En cas d'erreur, il s'arrête. Comme personne n'est présent au terminal dans le CI, --yes confirme la modification. La CLI lit à cette fin l'état actuel de chaque code QR. Important : via l'API, il n'y a au maximum 10 modifications de cible par heure et 30 par jour. L'étape convient donc pour une poignée de codes QR par version. Pour des changements plus importants, utilisez le tableau de bord ou le contrôle temporel.

Planification temporelle comme alternative

Si le moment est fixé à l'avance, par exemple un lancement lundi à 9 heures, la planification temporelle est disponible à partir du forfait Pro : un code QR redirige à partir d'une date ou à des heures spécifiques vers une autre cible, dans le fuseau horaire du code QR, avec jusqu'à 10 règles. Une étape dans le déploiement n'est alors pas nécessaire.

Revenir en arrière en cas d'erreur

Conserve l'ancienne affectation. Un rollback est alors la même étape avec le fichier précédent. De plus, Same-QR vérifie toutes les nuits toutes les cibles et envoie un e-mail si l'une d'elles n'est pas accessible.

Conclusion : pourquoi Same-QR

Avec Same-QR, les codes QR imprimés deviennent partie intégrante de votre déploiement : une CLI qui s’intègre à tout pipeline, protection contre les écritures parallèles, planification à partir des points forts et vérification nocturne des cibles comme filet. Aucun code QR ne mène à vide après une publication.

Lancez-vous tout de suite : inscrivez-vous gratuitement sur sameqr.com, 20 codes QR dynamiques sont gratuits pour toujours. L’API, la CLI et le serveur MCP sont inclus dans chaque offre, la documentation se trouve sur sameqr.com/entwickler.

Questions fréquentes