MOSAQO API
واجهة برمجة التطبيقات العامة وخطافات الويب لأتمتة QR
يستخدم Mosaqo Public API مفاتيح على نطاق مساحة العمل. ابدأ بالحد الأدنى من النطاق، واستخدم Idempotency-Key للكتابة واحترم "إعادة المحاولة بعد" عندما يكون المعدل محدودًا.
نظرة سريعة
ما الذي يتغير عمليًا
01
المصادقة والنطاقات
أرسل السر في X-Mosaqo-API-Key. تشمل النطاقات المتوفرة qr:read وqr:write وexports:read وanalytics:read. يمكن أن تنتهي صلاحية المفاتيح أو يتم إبطالها أو استخدام قائمة IP المسموح بها.
- لا تضع سرًا أبدًا في JavaScript الخاصة بالعميل
- استخدم مفتاحًا واحدًا لكل تكامل
- قم بالتدوير بعد التعرض المشتبه به
02
إعادة محاولة الكتابة الآمنة
يتطلب إنشاء الطلبات ونشرها وجود مفتاح Idempotency يتراوح بين 1 و128 حرفًا. أعد استخدام المفتاح فقط لإعادة محاولة استخدام الحمولة المتطابقة خلال 24 ساعة.
03
حدود المعدل والأخطاء
في HTTP 429، اقرأ "إعادة المحاولة بعد" ثم أعد المحاولة مع التراجع. يشير الرقم 401 عادةً إلى مفتاح مفقود أو ملغى أو منتهي الصلاحية أو مقيد أو غير محدد النطاق بشكل كافٍ.
04
خطافات الويب
اشترك فقط في الأحداث المطلوبة، واقبلها على HTTPS واستجب لها بسرعة. يسجل Mosaqo حالة التسليم ويدعم إعادة التشغيل من مساحة العمل.
FAQ
الأسئلة الشائعة
أين عقد API الكامل؟
تم إصدار عقد OpenAPI 3.1 مع Mosaqo API. قم بإنشاء مفتاح في مساحة عمل الويب واستخدم العقد المنشور للحصول على تفاصيل نقطة النهاية.
الخطوة التالية