Same-QR للمطورين: الواجهة البرمجية وخادم MCP وأداة CLI في لمحة

ثلاث طرق وصول وحساب واحد

Same-QR للمطورين يعني أن كل ما تفعله لوحة التحكم متاح أيضًا عبر واجهة REST، وكخادم MCP لمساعدي الذكاء الاصطناعي، وعبر سطر الأوامر. تستدعي الثلاثة الوظائف نفسها، بحدود الباقات والفحوص نفسها، والثلاثة مشمولة في كل باقة.

الوصول

تنشئ المفاتيح في لوحة التحكم تحت «الحساب»، في «الوصول لـ CLI والسكربتات والوكلاء»: «قراءة فقط»، أو «قراءة وكتابة» (إنشاء وتغيير الأسماء والنصوص)، أو «كامل» (وتغيير الوجهات وإيقاف الرموز وحذفها أيضًا). مدة الصلاحية 30 أو 90 أو 180 أو 365 يومًا أو بلا حدود عن قصد، وحتى 10 مفاتيح لكل حساب. يبدأ المفتاح بـ sqr_live_ ويُعرض مرة واحدة، ومكانه في متغير البيئة SAMEQR_API_KEY.

واجهة 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 والإحصاءات وصفحات الضيوف وقوائم الطعام من الصور والتصنيفات ومشاريع العملاء والطلبات. تصل الأخطاء بشكل موحّد ككائن error فيه status وcode وmessage. الوصف الكامل موجود على /api/v1/openapi.json. الحدود: 120 طلبًا في الدقيقة لكل مفتاح، وفي الساعة 60 أو 300 أو 1.000 أو 5.000 بحسب الباقة.

خادم MCP

العنوان https://sameqr.com/api/mcp. يضيفه ChatGPT وClaude.ai كموصّل ويسجّلان الدخول عبر OAuth. أما في Claude Code:

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

لـ Cursor وCodex يعرض الأمر «sameqr mcp» الإدخالات الخاصة بالملفين ~/.cursor/mcp.json و~/.codex/config.toml. ومع مفتاح للقراءة فقط لا يرى الوكيل إلا أدوات القراءة.

أداة 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

بلا تبعيات، ابتداءً من Node.js 18، مع --json للسكربتات وقيم إرجاع واضحة للأخطاء. الأمر «sameqr --help» يعرض كل الأوامر.

من أين تبدأ

• سجّل مجانًا وأكّد بريدك الإلكتروني.
• أنشئ مفتاح «قراءة فقط» وجرّب «sameqr whoami».
• اقرأ الأدلة على sameqr.com/entwickler.
• ثم اختر الطريق الذي يناسب مشروعك.

الخلاصة: لماذا Same-QR

يضع Same-QR الخدمة كاملة بين يدي المطورين، لا جزءًا منها فقط: واجهة برمجية وخادم MCP وأداة CLI بوظائف لوحة التحكم نفسها، مع تعامل دقيق مع المفاتيح وحدود موثقة بوضوح. 20 رمز QR ديناميكيًا مجانية بشكل دائم، وهذا يكفي للتجربة.

ابدأ الآن: سجّل مجانًا على sameqr.com، و20 رمز QR ديناميكيًا مجانية بشكل دائم. الواجهة البرمجية وأداة CLI وخادم MCP متاحة في كل باقة، والتوثيق على sameqr.com/entwickler.

الأسئلة الشائعة