CLI con --json: procesa las salidas de Same-QR en tus scripts

Por qué JSON para programas

Los programas de línea de comandos suelen responder para personas: una frase, una tabla. Un script tendría que trocear ese texto y confiar en que el formato no cambie nunca. JSON es un formato de texto para datos estructurados que casi cualquier lenguaje sabe leer. Una CLI con salida JSON entrega la misma información en una forma fija.

La opción --json

Todos los comandos de la CLI sameqr conocen --json. En lugar de la tabla, recibes la respuesta de la API en JSON:

sameqr qr list --json
sameqr qr create --name "Plakat Nord" --url https://example.com/aktion --json
sameqr seite list --json

Procesar con jq

En scripts de shell, la pequeña herramienta jq extrae valores concretos. Así puedes listar el nombre y los escaneos de todos tus códigos QR o guardar el identificador de un código QR nuevo:

sameqr qr list --json | jq -r '.codes[] | "\(.name);\(.scanCount)"'

id=$(sameqr qr create --name "Plakat Süd" --url https://example.com/aktion --json | jq -r .id)
sameqr qr stats "$id"

Detectar errores en el script

Con --json, los errores también llegan como JSON, y lo hacen por la salida de errores para no mezclarse con los datos propiamente dichos. Además, el código de salida revela el tipo de error:

• 0: todo en orden.
• 2: entrada incorrecta o ausente, por ejemplo un --name olvidado.
• 3: sin sesión iniciada o clave no válida.
• 4: sin permiso, por ejemplo con una clave de “solo lectura” o por un límite del plan.
• 1: otro error de la API.

Interrumpe los bucles en el primer error en lugar de producir cien veces el mismo fallo, por ejemplo con “|| break” detrás del comando.

Ejemplos de flujos

• Una lista de ubicaciones se convierte en códigos QR y las respuestas JSON acaban en un archivo para la imprenta.
• Una tarea mensual guarda “sameqr qr list --json” como punto de partida para el informe de escaneos.
• Un agente de programación llama él mismo a la CLI y lee las respuestas JSON para planificar los siguientes pasos.

Conclusión: por qué Same-QR

La CLI sameqr está pensada para scripts: JSON cuando lo pides, errores bien separados y con códigos de salida inequívocos, y la clave tomada del entorno en lugar de la línea de comandos. Así, los comandos sueltos se convierten en flujos fiables, con Same-QR en todos los planes.

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

Preguntas frecuentes