Kod QR përmes vijës së komandës: instalo dhe përdor CLI-në sameqr

Pse vija e komandës

Një CLI (Command Line Interface) është një program që e përdor me komanda teksti në terminal. Një komandë mund të përsëritet, të shkruhet në një skript, të lidhet me mjete të tjera dhe të ekzekutohet nga një agjent programimi. CLI-ja sameqr e sjell Same-QR pikërisht aty. Ajo nuk ka varësi të tjera dhe kërkon vetëm Node.js nga versioni 18.

Hapi 1: Instalo

CLI-ja vjen përmes npm, menaxherit të paketave të Node.js:

npm install -g sameqr
sameqr --version

Hapi 2: Krijo çelësin API

Në panel, te Llogaria, gjen seksionin „Qasje për CLI, skripta dhe agjentë“. Krijo atje një çelës. Për fillim mjafton „lexim + shkrim“: krijo, ndrysho emra dhe tekste. Kush dëshiron të ndryshojë edhe destinacionet e kodeve ekzistuese QR, të kthejë faqe jashtë linje ose t'i fshijë, zgjedh „i plotë“. Ai fillon me sqr_live_ dhe shfaqet vetëm një herë. Ruaje menjëherë në menaxherin e fjalëkalimeve.

Hapi 3: Hyr

Çelësi nuk jepet kurrë si argument, përndryshe do të shfaqej në historikun e shell-it. „sameqr login“ e kërkon të fshehur, e kontrollon dhe e ruan të lexueshëm vetëm për ty te ~/.config/sameqr/config.json. Si alternativë vendos ndryshoren e mjedisit SAMEQR_API_KEY, e cila ka gjithmonë përparësi.

sameqr login
sameqr whoami

„sameqr whoami“ tregon llogarinë tënde, planin dhe sa kode QR mund të krijosh.

Hapi 4: Krijo kodin e parë QR

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>

Me --slug përcakton gjatë krijimit një lidhje të shkurtër të vetën, me --label shton etiketa. Identifikuesit e tyre i tregon „sameqr labels list“. Ndryshimi i destinacionit, kthimi jashtë linje dhe fshirja kërkojnë një çelës „i plotë“. CLI-ja pastaj pyet në terminal, në skripta pa terminal funksionon vetëm me --yes të shprehur. Përmes API-t lejohen jo më shumë se 10 ndryshime të tilla në orë dhe 30 në ditë.

Hapi 5: Faqe mysafirësh dhe menyja

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“ nxjerr adresën e faqes së re, në shembull menu/gasthof-zum-loewen. Atë do ta përdorësh për komandat e mëpasshme. Faqja krijohet si draft. „karte import“ i lexon fotot me inteligjencë artificiale dhe i shton grupet e njohura në faqe, pa mbishkruar asgjë. Shiko draftin përpara se të publikosh. Për të publikuar duhet të jenë plotësuar të dhënat e operatorit. Komanda e fundit krijon një kod QR që drejton drejtpërdrejt te faqja. Shabllone të tjera: preisliste, zeiten, links, aktion, weingut, etikett dhe kontakt.

Hapi 6: Në skripta me --json

Nëse i shton --json një komande, përgjigjja vjen si JSON. Gabimet atëherë dalin gjithashtu si JSON në daljen e gabimeve, dhe vlera e kthimit tregon llojin: 3 do të thotë i paidentifikuar, 4 të drejta që mungojnë, 2 një hyrje e gabuar. Kështu një skript reagon në mënyrë të synuar, në vend që të interpretojë tekst.

sameqr qr list --json

Përfundim: pse Same-QR

CLI-ja sameqr e sjell gjithë gamën e funksioneve të Same-QR në terminal: kode QR, statistika, faqe mysafirësh, menyja nga fotot, etiketa dhe projekte. Ajo është e lehtë, e trajton me kujdes çelësin tënd dhe flet JSON për skriptat dhe agjentët e programimit. Dhe funksionon në çdo plan.

Fillo menjëherë: regjistrohu falas në sameqr.com, 20 kode QR dinamike janë falas përgjithmonë. API, CLI dhe serveri MCP ofrohen në çdo plan, dokumentacioni ndodhet te sameqr.com/entwickler.

Pyetje të shpeshta