Same-QR pentru dezvoltatori: API, server MCP și CLI dintr-o privire

Trei căi de acces, un singur cont

Same-QR pentru dezvoltatori înseamnă: tot ce poate panoul de control există și ca API REST, ca server MCP pentru asistenți IA și ca linie de comandă. Toate trei apelează aceleași funcții, cu aceleași limite de abonament și aceleași verificări, și toate trei sunt incluse în orice abonament.

Accesul

Cheile le creezi în panoul de control la Cont, „Acces pentru CLI, scripturi și agenți”: „doar citire”, „citire + scriere” (creare, modificare de nume și texte) sau „complet” (în plus modificare de destinații, scoatere offline, ștergere), durată de 30, 90, 180 sau 365 de zile sau, în mod deliberat, nelimitată, până la 10 pentru fiecare cont. Cheia începe cu sqr_live_, se afișează o singură dată și îi este locul în variabila de mediu SAMEQR_API_KEY.

API-ul 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

Coduri QR, statistici, pagini pentru clienți, meniuri din fotografii, etichete, proiecte pentru clienți și cereri. Erorile vin uniform sub forma unui obiect error cu status, code și message. Descrierea completă se află la /api/v1/openapi.json. Limite: 120 de cereri pe minut pentru fiecare cheie, pe oră 60, 300, 1.000 sau 5.000, în funcție de abonament.

Serverul MCP

Adresa https://sameqr.com/api/mcp. ChatGPT și Claude.ai îl adaugă ca conector și se autentifică prin OAuth. Pentru Claude Code:

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

Pentru Cursor și Codex, „sameqr mcp” arată intrările pentru ~/.cursor/mcp.json și ~/.codex/config.toml. Cu o cheie de citire, un agent vede doar instrumentele de citire.

CLI-ul

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

Fără dependențe, de la Node.js 18, cu --json pentru scripturi și valori de retur clare pentru erori. „sameqr --help” arată toate comenzile.

De unde începi

• Înregistrează-te gratuit și confirmă adresa de e-mail.
• Creează o cheie „doar citire” și încearcă „sameqr whoami”.
• Citește ghidurile de pe sameqr.com/entwickler.
• Apoi alege calea care se potrivește proiectului tău.

Concluzie: de ce Same-QR

Same-QR le dă dezvoltatorilor întregul serviciu în mână, nu doar o bucată: API, server MCP și CLI cu aceleași funcții ca panoul de control, cu o grijă atentă pentru chei și cu limite documentate deschis. 20 de coduri QR dinamice sunt gratuite pe termen nelimitat, pentru a încerca ajunge.

Începe chiar acum: înregistrează-te gratuit pe sameqr.com, 20 de coduri QR dinamice sunt gratuite pe termen nelimitat. API, CLI și serverul MCP există în orice abonament, documentația se află pe sameqr.com/entwickler.

Întrebări frecvente