Same-QR za programere: API, MCP server i CLI na prvi pogled

Tri pristupa, jedan nalog

Same-QR za programere znači: sve što može kontrolna tabla postoji i kao REST API, kao MCP server za AI asistente i kao komandna linija. Sva tri pozivaju iste funkcije, sa istim ograničenjima tarife i istim proverama, i sva tri su uključena u svaku tarifu.

Pristup

Ključeve praviš u kontrolnoj tabli pod Nalog, „Pristup za CLI, skripte i agente“: „samo čitanje“, „čitanje + pisanje“ (pravljenje, izmena imena i tekstova) ili „potpuno“ (dodatno izmena odredišta, uzimanje van mreže, brisanje), trajanje 30, 90, 180 ili 365 dana ili namerno neograničeno, do 10 po nalogu. Ključ počinje sa sqr_live_, prikazuje se samo jednom i treba da se čuva u promenljivoj 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 klijenata i upiti. Greške stižu ujednačeno kao objekat error sa status, code i message. Potpun opis je na /api/v1/openapi.json. Ograničenja: 120 zahteva u minuti po ključu, na sat 60, 300, 1.000 ili 5.000, zavisno od tarife.

MCP server

Adresa https://sameqr.com/api/mcp. ChatGPT i Claude.ai dodaju ga kao konektor i prijavljuju se preko 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. Sa 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, sa --json za skripte i jednoznačnim povratnim vrednostima za greške. „sameqr --help“ prikazuje sve komande.

Odakle da počneš

• Registruj se besplatno i potvrdi mejl adresu.
• Napravi ključ „samo čitanje“ i probaj „sameqr whoami“.
• Pročitaj uputstva na sameqr.com/entwickler.
• Zatim izaberi put koji odgovara tvom projektu.

Zaključak: zašto Same-QR

Same-QR daje programerima ceo servis u ruke, a ne samo isečak: API, MCP server i CLI sa istim funkcijama kao kontrolna tabla, pažljivim postupanjem sa ključevima i otvoreno dokumentovanim ograničenjima. 20 dinamičkih QR kodova je trajno besplatno, za isprobavanje to je dovoljno.

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

Često postavljana pitanja