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