Geliştiriciler için Same-QR: API, MCP sunucusu ve CLI tek bakışta

Üç erişim yolu, tek hesap

Geliştiriciler için Same-QR şu demek: Kontrol panelinin yapabildiği her şey REST API olarak, yapay zeka asistanları için MCP sunucusu olarak ve komut satırı olarak da var. Üçü de aynı işlevleri, aynı tarife sınırlarıyla ve aynı kontrollerle çağırır, üçü de her tarifeye dahildir.

Erişim

Anahtarları kontrol panelinde Hesap bölümünde, “CLI, betikler ve ajanlar için erişim” altında oluşturursun: “salt okunur”, “okuma + yazma” (oluşturma, ad ve metin değiştirme) ya da “tam” (ek olarak hedef değiştirme, çevrimdışı alma, silme). Geçerlilik süresi 30, 90, 180 ya da 365 gün veya bilerek sınırsız olabilir, hesap başına en fazla 10 anahtar. Anahtar sqr_live_ ile başlar, yalnızca bir kez gösterilir ve SAMEQR_API_KEY ortam değişkenine konur.

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 kodlar, istatistikler, misafir sayfaları, fotoğraflardan menüler, etiketler, müşteri projeleri ve talepler. Hatalar her zaman aynı biçimde, status, code ve message içeren bir error nesnesi olarak gelir. Tam açıklama /api/v1/openapi.json adresinde. Sınırlar: anahtar başına dakikada 120 istek, tarifeye göre saatte 60, 300, 1.000 ya da 5.000 istek.

MCP sunucusu

Adres https://sameqr.com/api/mcp. ChatGPT ve Claude.ai bunu bağlayıcı olarak ekler ve OAuth ile giriş yapar. Claude Code için:

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

Cursor ve Codex için “sameqr mcp” komutu ~/.cursor/mcp.json ve ~/.codex/config.toml dosyalarına girilecek satırları gösterir. Okuma anahtarıyla bir ajan yalnızca okuyan araçları görür.

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

Bağımlılık yok, Node.js 18 ve üzeri, betikler için --json seçeneği ve hatalar için net dönüş değerleri var. “sameqr --help” tüm komutları gösterir.

Nereden başlamalı

• Ücretsiz kaydol ve e-posta adresini doğrula.
• “Salt okunur” bir anahtar oluştur ve “sameqr whoami” komutunu dene.
• sameqr.com/entwickler adresindeki kılavuzları oku.
• Sonra projene uyan yolu seç.

Sonuç: Neden Same-QR

Same-QR geliştiricilere hizmetin tamamını verir, yalnızca bir kısmını değil: kontrol paneliyle aynı işlevlere sahip API, MCP sunucusu ve CLI, anahtarlara özenli yaklaşım ve açıkça belgelenmiş sınırlar. 20 dinamik QR kod kalıcı olarak ücretsiz, denemek için bu yeterli.

Hemen başla: sameqr.com'da ücretsiz kaydol, 20 dinamik QR kod kalıcı olarak ücretsiz. API, CLI ve MCP sunucusu her tarifede var, belgeler sameqr.com/entwickler adresinde.

Sık sorulan sorular