QR-Code via ligne de commande : Installer et utiliser la CLI sameqr

Pourquoi la ligne de commande

Une CLI (Command Line Interface) est un programme que vous utilisez via des commandes textuelles dans le terminal. Une commande peut être répétée, écrite dans un script, enchaînée avec d'autres outils et exécutée par un agent de codage. La CLI sameqr amène Same-QR exactement là. Elle n'a pas d'autres dépendances et nécessite uniquement Node.js à partir de la version 18.

Étape 1 : Installation

La CLI est disponible via npm, le gestionnaire de paquets de Node.js :

npm install -g sameqr
sameqr --version

Étape 2 : Créer une clé API

Dans le tableau de bord, sous Compte, vous trouverez la section « Accès pour CLI, scripts et agents ». Créez-y une clé. Pour commencer, « lecture + écriture » suffit : créer, modifier les noms et les textes. Ceux qui souhaitent également modifier les cibles des codes existants, mettre les pages hors ligne ou les supprimer, choisissent « complet ». Elle commence par sqr_live_ et ne s’affiche qu’une seule fois. Enregistrez-la immédiatement dans votre gestionnaire de mots de passe.

Étape 3 : Connexion

La clé n'est jamais transmise en tant qu'argument, sinon elle apparaîtrait dans l'historique du shell. « sameqr login » la demande de manière masquée, la vérifie et la stocke de manière lisible uniquement pour vous dans ~/.config/sameqr/config.json. Alternativement, vous pouvez définir la variable d'environnement SAMEQR_API_KEY, qui a toujours la priorité.

sameqr login
sameqr whoami

« sameqr whoami » affiche votre compte, le forfait et le nombre de codes que vous pouvez créer.

Étape 4 : Créer le premier code

sameqr qr create --name "Speisekarte Tische" --url https://example.com/karte
sameqr qr list
sameqr qr update <id> --url https://example.com/winterkarte
sameqr qr stats <id>

Avec --slug, vous définissez un propre lien court lors de la création, avec --label vous ajoutez des étiquettes. Le CLI affiche leurs identifiants via « sameqr labels list ». Modifier la cible, mettre hors ligne et supprimer nécessitent une clé « complet ». Le CLI demande alors dans le terminal ; dans les scripts sans terminal, cela ne fonctionne qu’avec --yes explicite. Via l’API, au maximum 10 de ces modifications par heure et 30 par jour sont possibles.

Étape 5 : Pages hébergées et cartes de restaurant

sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte-1.jpg karte-2.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen
sameqr qr create --name "Tischaufsteller" --seite menu/gasthof-zum-loewen

«seite create» affiche l'adresse de la nouvelle page, dans l'exemple menu/gasthof-zum-loewen. Vous en avez besoin pour les commandes suivantes. La page est créée en tant que brouillon. «karte import» lit les photos via l'IA et attache les groupes reconnus à la page, sans rien écraser. Consultez le brouillon avant de publier. Pour publier, les informations de l'exploitant doivent être remplies. La dernière commande génère un code qui pointe directement vers la page. Autres modèles : preisliste, zeiten, links, aktion, weingut, etikett et kontakt.

Étape 6 : Dans les scripts avec --json

Si vous ajoutez --json à une commande, la réponse est renvoyée au format JSON. Les erreurs sont également transmises au format JSON sur la sortie d'erreur, et la valeur de retour indique le type : 3 signifie non authentifié, 4 signifie droits insuffisants, 2 signifie une entrée incorrecte. Un script réagit ainsi de manière ciblée, au lieu d'interpréter du texte.

sameqr qr list --json

Conclusion : pourquoi Same-QR

La CLI sameqr apporte toute la fonctionnalité de Same-QR dans le terminal : codes, statistiques, pages hébergées, menus à partir de photos, étiquettes et projets. Elle est légère, gère soigneusement votre clé et utilise JSON pour les scripts et les agents de codage. Et elle fonctionne dans tous les tarifs.

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.

Questions fréquentes