CLI met --json: Same-QR-uitvoer verwerken in scripts

Waarom JSON voor programma's

Opdrachtregelprogramma's antwoorden meestal voor mensen: een zin, een tabel. Een script zou die tekst moeten opknippen en hopen dat de indeling nooit verandert. JSON is een tekstformaat voor gestructureerde gegevens dat vrijwel elke programmeertaal kan lezen. Een CLI met JSON-uitvoer levert dezelfde informatie in een vaste vorm.

De optie --json

Elk commando van de sameqr-CLI kent --json. In plaats van de tabel krijg je dan het antwoord van de API als JSON:

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

Verder verwerken met jq

In shellscripts haalt het kleine hulpmiddel jq losse waarden eruit. Zo som je de naam en het aantal scans van al je QR-codes op, of onthoud je de id van een nieuwe QR-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"

Fouten herkennen in een script

Met --json komen ook fouten als JSON binnen, en wel op de foutuitvoer, zodat ze de eigenlijke gegevens niet vermengen. Daarnaast verraadt de exitcode het soort fout:

• 0: alles in orde.
• 2: onjuiste of ontbrekende invoer, bijvoorbeeld een vergeten --name.
• 3: niet aangemeld of sleutel ongeldig.
• 4: geen toestemming, bijvoorbeeld bij een sleutel met alleen leesrechten of een tariefgrens.
• 1: een andere fout van de API.

Breek lussen af bij de eerste fout, in plaats van honderd keer dezelfde fout te produceren, bijvoorbeeld met "|| break" achter het commando.

Voorbeelden van workflows

• Een lijst met locaties wordt omgezet in QR-codes, de JSON-antwoorden belanden in een bestand voor de drukkerij.
• Een maandelijkse taak slaat "sameqr qr list --json" op als basis voor het scanrapport.
• Een coding agent roept de CLI zelf aan en leest de JSON-antwoorden om de volgende stappen te plannen.

Conclusie: waarom Same-QR

De sameqr-CLI is gebouwd voor scripts: JSON op verzoek, fouten netjes gescheiden en met eenduidige exitcodes, sleutels uit de omgeving in plaats van uit de opdrachtregel. Zo worden losse commando's betrouwbare workflows, met Same-QR in elk tarief.

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 tarief, de documentatie staat op sameqr.com/entwickler.

Veelgestelde vragen