Same-QR
InloggenGratis starten
Gratis starten
← Terug naar de blog
Handleiding2 min leestijd

QR-codes automatisch ordenen: labels via CLI, API en assistent

Afbeelding van Unsplash

Waarom orde bij veel QR-codes telt

Wie QR-codes wil ordenen, denkt er meestal te laat aan: als de lijst lang is en niemand meer weet welke QR-code op welke poster zit. Labels zijn trefwoorden die je aan QR-codes hangt, zoals locatie, campagne of klant. Same-QR staat tot 200 labels per account toe en tot 20 per QR-code. Daarna filter je in het dashboard, analyseer je groepen en geef je een assistent duidelijke opdrachten.

Stap 1: labels zinvol benoemen

  • Eén dimensie per label: „Filiaal Graz” en „Poster” in plaats van „Graz posters”.
  • Dezelfde schrijfwijze voor iedereen, ook voor scripts en assistenten.
  • Campagnes met periode: „Herfst 2026” in plaats van alleen „Herfst”.
  • Liever weinig duidelijke labels dan veel die overlappen.

Stap 2: labels aanmaken

Labels maak je aan in het dashboard, of je vraagt een assistent met Same-QR als connector: „Maak de labels Filiaal Graz, Filiaal Linz en Poster aan.” Via de REST-API lukt het met een POST-verzoek naar /api/v1/labels. De ID's van alle labels toont de opdrachtregel:

sameqr labels list

Stap 3: labels toekennen

Bij het aanmaken hang je labels er meteen aan, bij bestaande QR-codes vervangt „--label” de hele lijst:

sameqr qr create --name "Graz Tisch 4" --url https://example.com/karte --label <label-graz>
sameqr qr update <id> --label <label-graz> --label <label-plakat>

Via de API stuur je met een PATCH-verzoek naar /api/v1/qr/<id> het veld labels met alle ID's die de QR-code moet dragen.

Stap 4: opruimen met een assistent

Voor bestaande verzamelingen is een assistent ideaal, omdat hij namen en bestemmingen kan lezen en zinvol kan indelen:

  • „Bekijk alle QR-codes en stel me labels voor per locatie. Verander nog niets.”
  • „Hang aan alle QR-codes waarvan de naam met Graz begint het label Filiaal Graz.”
  • „Welke QR-codes hebben nog helemaal geen label?”

Laat bij grotere wijzigingen eerst de lijst zien. Wordt een label verwijderd, dan blijven de QR-codes bestaan en verliezen alleen het label.

Projecten voor klanten

In de betaalde abonnementen is er een niveau boven de labels: klantprojecten. Een QR-code hoort bij hooguit één project, labels gelden over alle projecten heen. Zo scheid je klanten netjes en orden je binnen elke klant verder op locatie of campagne. „sameqr projekte list” toont de ID's, „--projekt” bij het aanmaken wijst toe.

Conclusie: waarom Same-QR

Same-QR geeft je orde die meegroeit: 100 labels, klantprojecten in de betaalde abonnementen en toegang daartoe vanuit dashboard, CLI, API en assistent. Zo vind je elke QR-code terug, ook als het er honderden zijn.

Ga meteen aan de slag: registreer 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.

Maak gratis dynamische QR-codes
Begin met 20 dynamische QR-codes die voor altijd gratis zijn. Geen abonnement, geen creditcard.
Nu gratis beginnen →

Veelgestelde vragen

Hoeveel labels kan ik aanmaken?

Tot 200 per account en tot 20 per QR-code.

Wat gebeurt er met QR-codes als ik een label verwijder?

Ze blijven bestaan en verliezen alleen dat label.

Wat is het verschil tussen label en project?

Een QR-code hoort bij hooguit één klantproject, maar kan veel labels dragen. Projecten zijn er in de betaalde abonnementen.

Nieuwsbrief

Nieuwe artikelen rechtstreeks in je inbox

Tips over dynamische QR-codes, nieuwe functies, geen spam. Altijd opzegbaar.

Door je aan te melden stem je in met het ontvangen van de nieuwsbrief. Je kunt je toestemming op elk moment intrekken via de afmeldlink in elke e-mail.

Verder lezen