Same-QR za razvijalce: API, strežnik MCP in CLI na prvi pogled

Trije dostopi, en račun

Same-QR za razvijalce pomeni: vse, kar zna nadzorna plošča, obstaja tudi kot API REST, kot strežnik MCP za pomočnike z umetno inteligenco in kot ukazna vrstica. Vsi trije kličejo iste funkcije, z istimi omejitvami tarif in preverjanji, in vsi trije so vključeni v vsako tarifo.

Dostop

Ključe ustvariš na nadzorni plošči pod Račun, »Dostop za CLI, skripte in agente«: »samo branje«, »branje + pisanje« (ustvarjanje, spreminjanje imen in besedil) ali »polno« (dodatno spreminjanje ciljev, izklop, brisanje), veljavnost 30, 90, 180 ali 365 dni ali namerno neomejena, do 10 na račun. Ključ se začne s sqr_live_, prikaže se enkrat in sodi v okoljsko spremenljivko SAMEQR_API_KEY.

API REST

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 kode, statistika, gostujoče strani, jedilniki iz fotografij, oznake, projekti strank in povpraševanja. Napake pridejo enotno kot objekt error s status, code in message. Popoln opis je na /api/v1/openapi.json. Omejitve: 120 zahtev na minuto na ključ, na uro 60, 300, 1.000 ali 5.000 glede na tarifo.

Strežnik MCP

Naslov https://sameqr.com/api/mcp. ChatGPT in Claude.ai ga dodata kot konektor in se prijavita prek OAuth. Za Claude Code:

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

Za Cursor in Codex »sameqr mcp« pokaže vnose za ~/.cursor/mcp.json in ~/.codex/config.toml. S ključem za branje agent vidi samo orodja za branje.

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

Brez odvisnosti, od Node.js 18 naprej, z --json za skripte in nedvoumnimi povratnimi vrednostmi za napake. »sameqr --help« pokaže vse ukaze.

Kje začeti

• Brezplačno se registriraj in potrdi e-poštni naslov.
• Ustvari ključ »samo branje« in preizkusi »sameqr whoami«.
• Preberi navodila na sameqr.com/entwickler.
• Nato izberi pot, ki ustreza tvojemu projektu.

Zaključek: zakaj Same-QR

Same-QR razvijalcem da v roke celotno storitev, ne le izseka: API, strežnik MCP in CLI z istimi funkcijami kot nadzorna plošča, skrbnim ravnanjem s ključi in odkrito dokumentiranimi omejitvami. 20 dinamičnih QR kod je trajno brezplačnih, za preizkus to zadošča.

Začni takoj: brezplačno se registriraj na sameqr.com, 20 dinamičnih QR kod je trajno brezplačnih. API, CLI in strežnik MCP so na voljo v vsaki tarifi, dokumentacija je na sameqr.com/entwickler.

Pogosta vprašanja