Códigos QR en el despliegue: cambia los destinos automáticamente tras un release

Códigos QR impresos y direcciones nuevas

En un release las páginas cambian de sitio: /sommerkarte pasa a ser /karte y /produkt-a pasa a ser /produkte/a. En la web lo resuelves con redirecciones. Pero los códigos QR impresos siguen apuntando a la dirección antigua, y las cadenas de redirecciones se alargan con cada release. Con los códigos QR dinámicos de Same-QR, en cambio, cambias el destino directamente a la dirección nueva.

Paso 1: la asignación en el repositorio

Anota a dónde debe apuntar cada código QR, por ejemplo en qr-ziele.csv, junto a tu código QR. Los identificadores los obtienes una sola vez con «sameqr qr list»:

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

Paso 2: una clave para el pipeline

En el panel, en Cuenta, «Acceso para CLI, scripts y agentes», crea una clave propia de nivel «completo» solo para el despliegue, porque los cambios de destino requieren ese nivel, con una duración adecuada. Guárdala como variable secreta SAMEQR_API_KEY en tu CI. La CLI la lee de ahí sin almacenarla.

Paso 3: cambiar los destinos tras el release

Cuando el despliegue termina con éxito, se ejecuta un paso breve:

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

El script comprueba primero si la dirección nueva responde y solo entonces hace el cambio. Si hay un error, se detiene. Como en la CI no hay nadie delante del terminal, --yes confirma el cambio. Para ello, la CLI lee antes el estado actual de cada código QR. Importante: a través de la API se permiten como máximo 10 cambios de destino por hora y 30 al día. Por tanto, este paso sirve para un puñado de códigos QR por release. Para cambios mayores, usa el panel o el control horario.

El control horario como alternativa

Si el momento se conoce de antemano, por ejemplo un lanzamiento el lunes a las 9 h, a partir de Gastro Pro o Marketing Pro dispones del control horario: un código QR redirige a otro destino desde una fecha o en ciertos horarios, en la zona horaria del código QR, con hasta 10 reglas. Así no hace falta ningún paso en el despliegue.

Volver atrás si algo sale mal

Conserva la asignación anterior. Un rollback es entonces el mismo paso con el archivo previo. Además, Same-QR comprueba todos los destinos cada noche y te envía un correo si alguno no está disponible.

Conclusión: por qué Same-QR

Con Same-QR, los códigos QR impresos pasan a formar parte de tu despliegue: una CLI que encaja en cualquier pipeline, protección contra sobrescrituras en paralelo, control horario a partir de Gastro Pro o Marketing Pro y una comprobación nocturna de los destinos como red de seguridad. Ningún código QR lleva a un callejón sin salida tras un release.

Empieza ya: regístrate gratis en sameqr.com, 20 códigos QR dinámicos son gratis para siempre. La API, la CLI y el servidor MCP están incluidos en todos los planes, y la documentación está en sameqr.com/entwickler.

Preguntas frecuentes