Same-QR za programere: API, MCP server i CLI na jednom mjestu

Tri pristupa, jedan račun

Same-QR za programere znači: sve što može nadzorna ploča postoji i kao REST API, kao MCP server za AI asistente i kao komandna linija. Sva tri pozivaju iste funkcije, s istim ograničenjima tarifa i istim provjerama, a sva tri su uključena u svaki tarif.

Pristup

Ključeve kreiraš na nadzornoj ploči pod Račun, „Pristup za CLI, skripte i agente“: „samo čitanje“, „čitanje + pisanje“ (kreiranje, promjena naziva i tekstova) ili „potpuno“ (dodatno mijenjanje odredišta, isključivanje, brisanje). Trajanje je 30, 90, 180 ili 365 dana ili namjerno neograničeno, do 10 po računu. Ključ počinje s sqr_live_, prikazuje se samo jednom i pripada u varijablu okruženja SAMEQR_API_KEY.

REST API

curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/konto
curl -H "Authorization: Bearer $SAMEQR_API_KEY" https://sameqr.com/api/v1/qr

QR kodovi, statistika, stranice za goste, jelovnici iz fotografija, oznake, projekti klijenata i upiti. Greške dolaze ujednačeno kao objekt error s poljima status, code i message. Potpuni opis nalazi se na /api/v1/openapi.json. Ograničenja: 120 zahtjeva u minuti po ključu, po satu 60, 300, 1.000 ili 5.000 zavisno od tarifi.

MCP server

Adresa je https://sameqr.com/api/mcp. ChatGPT i Claude.ai dodaju ga kao konektor i prijavljuju se putem OAuth-a. Za Claude Code:

claude mcp add --transport http sameqr https://sameqr.com/api/mcp --header "Authorization: Bearer $SAMEQR_API_KEY"

Za Cursor i Codex „sameqr mcp“ prikazuje unose za ~/.cursor/mcp.json i ~/.codex/config.toml. S ključem za čitanje agent vidi samo alate za čitanje.

CLI

npm install -g sameqr
sameqr login
sameqr qr create --name "Speisekarte" --url https://example.com/karte
sameqr seite create --vorlage speisekarte --name "Gasthof zum Löwen"
sameqr karte import karte.jpg --seite menu/gasthof-zum-loewen
sameqr seite publish menu/gasthof-zum-loewen

Bez zavisnosti, od Node.js 18 naviše, s opcijom --json za skripte i jasnim povratnim vrijednostima za greške. „sameqr --help“ prikazuje sve naredbe.

Odakle početi

• Registruj se besplatno i potvrdi e-mail adresu.
• Kreiraj ključ „samo čitanje“ i isprobaj „sameqr whoami“.
• Pročitaj upute na sameqr.com/entwickler.
• Zatim odaberi put koji odgovara tvom projektu.

Zaključak: Zašto Same-QR

Same-QR programerima daje cijelu uslugu u ruke, a ne samo isječak: API, MCP server i CLI s istim funkcijama kao nadzorna ploča, pažljivim rukovanjem ključevima i otvoreno dokumentiranim ograničenjima. 20 dinamičkih QR kodova trajno je besplatno, za isprobavanje je to sasvim dovoljno.

Počni odmah: registruj se besplatno na sameqr.com, 20 dinamičkih QR kodova trajno je besplatno. API, CLI i MCP server dostupni su u svakom tarifu, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja