واجهة ترخيص البرامج: التفعيل والتحقق والنبضات
اختر اللغة والعملية ثم استدعِ SDK. يتولى التفعيل وهوية الجهاز والتحقق من التوقيع والتخزين المؤقت والنبضات وحجز الاستخدام وتأكيده وإلغاءه.
Common scenario snippets
في الأمثلة، يأتي client من البدء وpath هو مسار التصدير وexportReport / export_report هي دالتك. jobID معرف ثابت تحفظه تطبيقات الاستخدام المحسوب.
راجع الكود الكامل ← · البدء السريع · راجع دمج الاستخدام المحسوب وإعادة المحاولة ←
ينفذ SDK العملية عند السماح فقط. لا يخصم RunFeature استخدامًا؛ يحجز RunMeteredFeature ويؤكد النجاح ويلغي الفشل. أعد المهمة الأصلية لتسوية التأكيد دون تكرار العملية المكتملة.
Complete SDK method reference
The scenarios above are short call snippets. Below are the current language’s public methods, properties and utilities, including full signatures, parameters, results, errors, configuration and data fields. The reference follows the selected language and identifies capabilities that are unavailable in a wrapper.
عرض طلبات HTTP واستجاباتها (للعملاء المخصصين أو استكشاف الأخطاء)
تنفّذ حزم SDK البروتوكول أدناه. لا تحتاج التطبيقات التي تستخدم حزم SDK التسع إلى تنفيذه من جديد.
تتحقق الواجهات الثماني من الترخيص وهوية الجهاز دون ملفات دخول أو CSRF أو مفاتيح إدارة. تُحرر الجلسات العائمة عند الخروج ويبقى تسجيل الأجهزة المرتبطة.
كيف أفحص السماح بعد التفعيل أو التحقق أو النبضات؟
- تأكد من HTTP 200 واقرأ
data.activation_id. أرسل هذا المعرّف مع التحقق والنبضات والقياس وفك الربط لاحقًا. - تحقق بمفتاح المنتج العام الموثوق مسبقًا
data.leaseثم طابق المنتج والجهاز والمدة والميزات. فك payload إلى JSON وحده لا يثبت صلاحية الترخيص. - ينفّذ SDK أول خطوتين تلقائيًا. يفحص RunFeature الصلاحية قبل العمل، ويتولى RunMeteredFeature الحجز والتأكيد والإلغاء للعدادات.
يحفظ SDK الذاكرة الموقعة ويرسل النبضات وفق السياسة. لا تمسح ذاكرة صالحة لمجرد مهلة شبكة. عند الإلغاء أو التحرير أو الانتهاء الصريح، امنع الميزات المحمية حسب نتيجة SDK.
ما معاني حقول payload بعد فك الترميز؟
المثال لشرح البيانات فقط. عند تنفيذ التحقق استخدم بايتات payload الأصلية المستلمة؛ لا تعِد ترتيب JSON أو تسلسله قبل التحقق.
إعادة المحاولة والنبضات والفوترة
مطلوب للتفعيل وفك الربط والقياس Idempotency-Key، حتى 80 محرفًا دون مسافات. أنشئ قيمة جديدة لكل عملية، واحتفظ بالقيمة والنص عند إعادة المحاولة. اختياري للتحقق والنبضات؛ يدير SDK معرّفات طلباته.
ما دام التفويض ساريًا، يمكن إعادة طلبات التحقق والنبض المتطابقة لمدة ساعة دون احتساب رسوم مكررة. بعد هذه المدة، استخدم مفتاح طلب جديدًا؛ فقد يُعامل المفتاح القديم كطلب جديد. تحتفظ عمليات التفعيل وإلغاء التفعيل واستهلاك الميزات بسجلات دائمة لمنع تكرار التنفيذ.
كل تفعيل أو تحقق أو نبضة أو فك ربط ناجح يستهلك طلب API واحدًا. الفشل وإعادة الطلب المتماثل لا يعاد عدّهما؛ CheckFeature محلي. Consume يخصم استخدام الميزة لا حصة API هذه؛ quantity عدد الاستخدامات المستهلكة.
فاصل النبضات ومدة عدم الاتصال والدوام حسب سياسات الترخيص.payload.expires_at هو انتهاء الذاكرة الموقعة الحالية، وليس انتهاء الترخيص النهائي. راجع تفاصيل الترخيص للتاريخ النهائي.