Same-QR za programere: API, MCP poslužitelj 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 poslužitelj za AI asistente i kao naredbeni redak. Sva tri pozivaju iste funkcije, s istim ograničenjima paketa i istim provjerama, a sva tri su uključena u svaki paket.

Pristup

Ključeve izrađuješ na nadzornoj ploči pod Račun, „Pristup za CLI, skripte i agente“: „samo čitanje“, „čitanje + pisanje“ (izrada, promjena naziva i tekstova) ili „potpuno“ (dodatno promjena odredišta, isključivanje i brisanje). Trajanje je 30, 90, 180 ili 365 dana ili namjerno neograničeno, a po računu možeš imati do 10 ključeva. Ključ počinje s sqr_live_, prikazuje se samo jednom i treba ga spremiti 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, gostujuće stranice, jelovnici iz fotografija, oznake, projekti kupaca i upiti. Pogreške stižu ujednačeno kao objekt error sa statusom, kodom i porukom. Cjeloviti opis nalazi se na /api/v1/openapi.json. Ograničenja: 120 zahtjeva u minuti po ključu, a na sat 60, 300, 1.000 ili 5.000, ovisno o paketu.

MCP poslužitelj

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 naredba „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 ovisnosti, od Node.js 18, s opcijom --json za skripte i jasnim povratnim vrijednostima za pogreške. „sameqr --help“ prikazuje sve naredbe.

Odakle krenuti

• Besplatno se registriraj i potvrdi adresu e-pošte.
• Izradi ključ „samo čitanje“ i isprobaj „sameqr whoami“.
• Pročitaj upute na sameqr.com/entwickler.
• Zatim odaberi put koji odgovara tvojem projektu.

Zaključak: zašto Same-QR

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

Kreni odmah: besplatno se registriraj na sameqr.com, 20 dinamičkih QR kodova trajno je besplatno. API, CLI i MCP poslužitelj dostupni su u svakom paketu, a dokumentacija je na sameqr.com/entwickler.

Često postavljana pitanja