IA & automatisation2 min de lecture

CLI avec --json : traiter les sorties Same-QR dans des scripts

Bild von Unsplash

Pourquoi JSON pour les programmes

Les programmes en ligne de commande répondent généralement pour les humains : une phrase, un tableau. Un script devrait découper ce texte et espérer que le format ne change jamais. JSON est un format de texte pour les données structurées, que pratiquement n'importe quel langage peut lire. Une CLI avec une sortie JSON fournit les mêmes informations sous une forme fixe.

L'option --json

Chaque commande de la CLI sameqr connaît --json. Au lieu du tableau, la réponse de l'API est alors fournie en JSON :

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

Traitement avec jq

Dans les scripts shell, l'outil léger jq extrait les valeurs individuelles. Voici comment listez le nom et les scans de tous les codes ou comment mémoriser l'identifiant d'un nouveau code :

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"

Détection des erreurs dans le script

Avec --json, les erreurs arrivent également en JSON, et ce sur la sortie d'erreur, afin qu'elles ne mélangent pas les données réelles. De plus, le code de retour indique le type d'erreur :

0 : tout est en ordre.
2 : entrée incorrecte ou manquante, par exemple un --name oublié.
3 : non connecté ou clé invalide.
4 : aucune autorisation, par exemple une clé « lecture seule » ou une limite de tarif.
1 : une autre erreur de l'API.

Interrompez les boucles au premier erreur, au lieu de produire cent fois la même erreur, par exemple avec « || break » après la commande.

Exemples de flux

Une liste d'emplacements est convertie en codes, les réponses JSON sont enregistrées dans un fichier pour l'imprimerie.
Une tâche mensuelle enregistre « sameqr qr list --json » comme référence pour le rapport de scan.
Un agent de codage appelle la CLI lui-même et lit les réponses JSON pour planifier les prochaines étapes.

Conclusion : pourquoi Same-QR

La CLI sameqr est conçue pour les scripts : JSON si souhaité, erreurs clairement séparées et avec des valeurs de retour uniques, clés issues de l'environnement plutôt que de la ligne de commande. Ainsi, des commandes individuelles deviennent des flux fiables, avec Same-QR dans chaque tarif.

Lancez-vous tout de suite : inscrivez-vous gratuitement sur sameqr.com, deux 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.

Créez des QR codes dynamiques gratuitement

Commencez avec 2 QR codes dynamiques gratuits à vie. Sans abonnement, sans carte bancaire.

Commencer gratuitement →

Questions fréquentes

Dois-je toujours utiliser --json ?

Non. À la console, la sortie normale est plus agréable. --json est destiné aux scripts et aux programmes.

Où vont les messages d'erreur ?

Sur la sortie d'erreur, avec --json également sous forme de JSON contenant status, code et message. Les données elles-mêmes se trouvent sur la sortie normale.

Comment mon script détecte-t-il une clé manquante ?

La valeur de retour 3 indique une clé manquante. La valeur de retour 4 signifie un droit d’accès insuffisant.

Réservation

Réservez votre place avant le lancement.

Un e-mail dès le lancement de l’outil — avec les tarifs et l’offre gratuite. Pas de spam, désabonnement à tout moment.

Seulement jusqu’au lancementLancement dans les prochaines semaines

Votre compte gratuit est réservé — il n’y a de toute façon rien à payer pour l’instant
90 jours de modifications de destination illimitées au lieu de 30, réservé aux inscrits en avance
Prix de lancement garanti, même si nous augmentons plus tard

En vous inscrivant, vous consentez à recevoir la newsletter. Vous pouvez retirer ce consentement à tout moment via le lien de désabonnement présent dans chaque e-mail.