ميزة
أدر رموز QR من منظومتك الخاصة
واجهة REST API لإنشاء رموز QR وتحديثها وإدارتها بمفتاح API، إضافةً إلى webhooks تُخطر أنظمتك عند وقوع الأحداث.
امسحني
ما تغطيه واجهة API
تدعم واجهة API العامة عمليات إنشاء QR وقراءتها وتحديثها وحذفها. وهي موجّهة للتطبيقات التي تحتاج إلى توفير سجلات QR أو صيانتها كجزء من سير عمل قائم.
ومن الأنماط الشائعة إنشاء سجل QR عند إنشاء طلب أو منتج أو حملة، وتخزين المعرّف المُعاد، ثم تحديث الوجهة عند تغيّر السجل المصدر.
ابنِ عميلاً موثوقًا
- أصدر مفتاحًا محدود الصلاحية. امنح التكامل الأذونات التي يحتاجها فقط.
- استخدم الإحكام (idempotency). يجب ألا تنشئ الطلبات المتكررة سجلات إنتاج مكررة.
- عالج ردود الأخطاء. تتبع الأخطاء تفاصيل مشكلات على نمط RFC 9457.
- قسّم طلبات القوائم إلى صفحات. لا تفترض أن كل السجلات تُعاد في رد واحد.
- جدّد المفاتيح المكشوفة. تعامل مع بيانات اعتماد API كأي سر إنتاجي آخر.
ما هو خارج واجهة API العامة
لا يكشف السطح العام الحالي عن تحليلات لوحة التحكم أو تغذية خام لكل عملية مسح أو نقاط نهاية عامة للإنشاء بالجملة. وتوجد مهام CSV بالجملة في واجهة المنتج. وتغطي webhooks الصادرة أحداث دورة الحياة المدعومة، لكن لا يُطلَق أي webhook لكل عملية مسح.
استخدامات عملية
- وفّر رمز QR لموقع إلكتروني لكل حملة جديدة.
- أنشئ سجلات QR للمنتجات أو ملفات PDF من كتالوج داخلي.
- حدّث الوجهات عند انتقال مستند أو صفحة منتج.
- أوقف رمز QR مؤقتًا عند سحب سجل مصدر.
- أدر سجلات مستأجرين أو عملاء منفصلة بنموذج الملكية الخاص بك.
الأسئلة الشائعة حول واجهة API لرموز QR
ماذا يمكن لواجهة API أن تفعل؟
إنشاء سجلات QR الديناميكية وقراءتها وتحديثها وحذفها عبر REST — بمفاتيح API محدودة الصلاحية وطلبات مُحكمة (idempotent)، بحيث لا تنشئ إعادة المحاولات نسخًا مكررة أبدًا.
كيف أُصادِق؟
بمفتاح API محدود الصلاحية يُنشأ في إعدادات حسابك، ويُرسَل مع كل طلب. جدّده في أي وقت قد يكون فيه قد انكشف.
هل هناك حد للمعدل؟
نعم — 120 طلبًا في الدقيقة لكل مفتاح. تشمل Business ما يصل إلى 100,000 طلب API شهريًا؛ أما Enterprise فغير محدودة. ولا تشمل Starter والباقة المجانية الوصول إلى واجهة API.
هل توجد webhooks؟
نعم — تغطي webhooks أحداث دورة حياة QR والاشتراك والمستخدم والدفعات. لا يوجد webhook لكل عملية مسح.
هل تكشف واجهة API عن التحليلات؟
لا — واجهة API العامة سطح لإدارة QR. أما تحليلات المسح فتوجد في لوحة التحكم، حيث يمكنك أيضًا تصديرها.
ابنِ مع Qrcado
أنشئ حسابًا، وولّد مفتاح API محدود الصلاحية، وأتمِت رموزك.