Same-QR për zhvilluesit: API, server MCP dhe CLI në një vështrim

Tri hyrje, një llogari

Same-QR për zhvilluesit do të thotë: gjithçka që bën paneli, e ke edhe si API REST, si server MCP për asistentët e inteligjencës artificiale dhe si linjë komande. Të tria thërrasin të njëjtat funksione, me të njëjtat kufij të tarifave dhe të njëjtat kontrolle, dhe të tria përfshihen në çdo tarifë.

Qasja

Çelësat i krijon në panel te Llogaria, „Qasje për CLI, skripte dhe agjentë“: „vetëm lexim“, „lexim + shkrim“ (krijon, ndryshon emra dhe tekste) ose „i plotë“ (shtesë: ndryshon destinacionet, çaktivizon, fshin), me afat 30, 90, 180 ose 365 ditë ose me vetëdije pa kufi, deri në 10 për llogari. Çelësi fillon me sqr_live_, shfaqet vetëm një herë dhe vendoset në ndryshoren e mjedisit 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

Kodet QR, statistikat, faqet e mysafirëve, menytë nga fotot, etiketat, projektet e klientëve dhe kërkesat. Gabimet kthehen njëlloj, si objekt error me status, code dhe message. Përshkrimi i plotë gjendet te /api/v1/openapi.json. Kufijtë: 120 kërkesa në minutë për çelës, në orë 60, 300, 1.000 ose 5.000 sipas tarifës.

Serveri MCP

Adresa https://sameqr.com/api/mcp. ChatGPT dhe Claude.ai e shtojnë si konektor dhe hyjnë me OAuth. Për Claude Code:

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

Për Cursor dhe Codex, „sameqr mcp“ tregon shënimet për ~/.cursor/mcp.json dhe ~/.codex/config.toml. Me një çelës leximi, agjenti i shikon vetëm mjetet e leximit.

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

Pa varësi, nga Node.js 18, me --json për skriptet dhe me vlera kthimi të qarta për gabimet. „sameqr --help“ tregon të gjitha komandat.

Ku të fillosh

• Regjistrohu falas dhe konfirmo adresën e postës elektronike.
• Krijo një çelës „vetëm lexim“ dhe provo „sameqr whoami“.
• Lexo udhëzuesit në sameqr.com/entwickler.
• Pastaj zgjidh rrugën që i përshtatet projektit tënd.

Përfundim: pse Same-QR

Same-QR u jep zhvilluesve të gjithë shërbimin, jo vetëm një pjesë: API, server MCP dhe CLI me të njëjtat funksione si paneli, me kujdes ndaj çelësave dhe me kufij të dokumentuar hapur. 20 kode QR dinamike janë falas përgjithmonë, për t'i provuar mjafton.

Fillo menjëherë: regjistrohu falas në sameqr.com, 20 kode QR dinamike janë falas përgjithmonë. API, CLI dhe serveri MCP ofrohen në çdo tarifë, dokumentacioni gjendet te sameqr.com/entwickler.

Pyetje të shpeshta