QR-code via de opdrachtregel: de sameqr-CLI installeren en gebruiken

Waarom de opdrachtregel

Een CLI (Command Line Interface) is een programma dat je bedient met tekstopdrachten in de terminal. Een opdracht kun je herhalen, in een script zetten, aan andere tools koppelen en door een coding-agent laten uitvoeren. De sameqr-CLI brengt Same-QR precies daar. Ze heeft geen verdere afhankelijkheden en vraagt alleen Node.js vanaf versie 18.

Stap 1: Installeren

De CLI komt via npm, de pakketbeheerder van Node.js:

npm install -g sameqr
sameqr --version

Stap 2: API-sleutel aanmaken

In het dashboard onder Account vind je het onderdeel „Toegang voor CLI, scripts en agents“. Maak daar een sleutel aan. Om te beginnen volstaat „lezen + schrijven“: aanmaken, namen en teksten wijzigen. Wie ook de bestemmingen van bestaande QR-codes wil wijzigen, pagina's offline wil halen of wil verwijderen, kiest „volledig“. De sleutel begint met sqr_live_ en wordt maar één keer getoond. Sla hem meteen op in je wachtwoordmanager.

Stap 3: Inloggen

De sleutel geef je nooit als argument mee, anders zou hij in de shellgeschiedenis staan. „sameqr login“ vraagt hem verborgen op, controleert hem en slaat hem alleen voor jou leesbaar op in ~/.config/sameqr/config.json. Of je stelt de omgevingsvariabele SAMEQR_API_KEY in, die altijd voorrang heeft.

sameqr login
sameqr whoami

„sameqr whoami“ toont je account, het abonnement en hoeveel QR-codes je nog kunt aanmaken.

Stap 4: Je eerste QR-code aanmaken

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>

Met --slug leg je bij het aanmaken een eigen korte link vast, met --label voeg je labels toe. Hun ID's toont „sameqr labels list“. Bestemming wijzigen, offline halen en verwijderen vragen een sleutel „volledig“. De CLI vraagt dan in de terminal om bevestiging, in scripts zonder terminal lukt het alleen met een uitdrukkelijke --yes. Via de API zijn hoogstens 10 van zulke wijzigingen per uur en 30 per dag mogelijk.

Stap 5: Gastpagina's en menukaarten

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“ geeft het adres van de nieuwe pagina weer, in het voorbeeld menu/gasthof-zum-loewen. Dat heb je nodig voor de volgende opdrachten. De pagina ontstaat als concept. „karte import“ leest de foto's in met AI en voegt de herkende groepen toe aan de pagina, zonder iets te overschrijven. Loop het concept door voordat je publiceert. Om te publiceren moeten de gegevens van de exploitant zijn ingevuld. De laatste opdracht maakt een QR-code aan die direct naar de pagina verwijst. Overige sjablonen: preisliste, zeiten, links, aktion, weingut, etikett en kontakt.

Stap 6: In scripts met --json

Voeg je --json aan een opdracht toe, dan komt het antwoord als JSON. Fouten komen dan ook als JSON op de foutuitvoer, en de afsluitcode verraadt de soort: 3 betekent niet ingelogd, 4 ontbrekende rechten, 2 een onjuiste invoer. Zo reageert een script gericht, in plaats van tekst te moeten duiden.

sameqr qr list --json

Conclusie: waarom Same-QR

De sameqr-CLI brengt de volledige functionaliteit van Same-QR naar de terminal: QR-codes, statistieken, gastpagina's, menukaarten uit foto's, labels en projecten. Ze is slank, gaat zorgvuldig met je sleutel om en spreekt JSON voor scripts en coding-agents. En ze werkt in elk abonnement.

Ga meteen aan de slag: registreer je gratis op sameqr.com, 20 dynamische QR-codes zijn blijvend gratis. API, CLI en MCP-server zijn er in elk abonnement, de documentatie staat op sameqr.com/entwickler.

Veelgestelde vragen