مولّد رموز QR للمطورين: ما الذي يجعل الواجهة البرمجية جيدة

الصور الثابتة نادرًا ما تكفي

على مولّد رموز QR للمطورين أن يفعل أكثر من رسم الصور، فهذا تستطيع فعله أي مكتبة مجانية. قيمة الخدمة في رموز QR الديناميكية: عناوين قصيرة ثابتة يمكن تغيير وجهتها بعد الطباعة، مع إحصاءات ومراقبة.

رموز QR الديناميكية عبر الواجهة البرمجية

الواجهة الجيدة تفعل كل ما تفعله لوحة التحكم، لا إنشاء الرموز فقط. في Same-QR تستدعي واجهة REST على المسار /api/v1 الوظائف نفسها التي تستدعيها لوحة التحكم: رموز QR والإحصاءات والصفحات المستضافة وقوائم الطعام من الصور والتصنيفات ومشاريع العملاء والطلبات. الوصف المقروء آليًا موجود على /api/v1/openapi.json.

مفاتيح بصلاحيات منفصلة

• صلاحيات منفصلة، حتى لا تحتاج التقارير إلى صلاحية التعديل ولا تغيّر السكربتات وجهة رموز QR المطبوعة.
• مدد صلاحية، حتى لا تبقى المفاتيح المنسية سارية إلى الأبد.
• عرض المفتاح مرة واحدة فقط، وتخزينه على شكل بصمة تحقق فقط.
• بادئة ثابتة، حتى تعثر ماسحات الأسرار على المفاتيح المنشورة بالخطأ.
• إلغاء فوري.

يلبّي Same-QR هذه النقاط الخمس كلها: ثلاثة مستويات من «قراءة فقط» مرورًا بـ«قراءة وكتابة» إلى «كامل»، وتغيير الوجهة والحذف بتأكيد فقط، ومدة صلاحية من 30 إلى 365 يومًا أو بلا حدود عن قصد، وبادئة sqr_live_.

CLI وJSON وMCP

العمل الحديث يجري في الطرفية ومع الوكلاء الذكيين. أداة CLI بمخرجات JSON وقيم إرجاع واضحة يوفّر عليك ربطًا خاصًا، وخادم MCP يوصل الخدمة إلى Claude Code وCursor وCodex وChatGPT وClaude.ai. يقدّم Same-QR الاثنين: «npm install -g sameqr» وhttps://sameqr.com/api/mcp.

قائمة تحقق قبل القرار

• هل تستطيع الواجهة فعل كل ما تفعله لوحة التحكم؟
• هل توجد مفاتيح للقراءة فقط ومدد صلاحية؟
• هل الأخطاء موحّدة ومفهومة؟
• هل تحمي الواجهة من الكتابة المتزامنة فوق بعضها؟
• هل الحدود موثقة بوضوح؟
• هل الواجهة مشمولة في الباقة أم إضافة مكلفة؟
• هل توجد أداة CLI وخادم MCP للسكربتات والوكلاء؟

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

Same-QR مبني للمطورين: واجهة REST كاملة مع وصف OpenAPI، ومفاتيح قراءة، ومدد صلاحية، وحقل _rev لمنع الكتابة فوق التعديلات، وأخطاء موحّدة، وحدود موثقة بوضوح، وأداة CLI بلا تبعيات، وخادم MCP، في كل باقة.

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

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