API المنتجات والتراخيص

أصدر التراخيص من خادمك بعد الطلب: أنشئ المنتج والسياسة، ثم ترخيصًا لكل عميل. عادةً يُضبط المنتج والسياسة مرة واحدة.

أنشئ في اللوحة بصلاحية كتابة مفتاح API للإدارة. تستخدم الأمثلة التالية Authorization: Bearer YOUR_MANAGEMENT_API_KEY؛ احتفظ بهذا المفتاح على خادم المورّد.

The examples above show the minimum issuance flow. For queries, updates, archiving, renewals, devices, usage, offline licensing and events, see “All management requests and responses” under Management API Key.

أدخل أيام الصلاحية عند الإصدار: من 1 إلى 36500 للمحدد والتجريبي، واتركها للدائم. لا تخزن السياسة هذه المدة.

ماذا أحفظ بعد الإنشاء؟

استخدم data.id في استجابة المنتج بوصفه product_id، وdata.id في استجابة السياسة بوصفه policy_id. بعد إصدار الترخيص، احفظ data.id وdata.key.

يمكنك عرض المفتاح الكامل ونسخه مجددًا من قائمة التراخيص. شاركه مع العميل المعني فقط.

لترخيص محدد المدة قبل التفعيل،expires_at و first_activated_at تكون null. تبدأ المدة من أول تفعيل ناجح؛ النقل لا يمنح مدة جديدة.

الإدارة اللاحقة

الطريقة والمسار دون /api/v1	الغرض وجسم الطلب
`GET /products`	استعرض المنتجات. في الاستجابة، data.items مصفوفة السجلات وdata.total عددها الإجمالي.
`GET /licenses/{id}`	اعرض تفاصيل الترخيص وأول تفعيل والانتهاء.
`POST /licenses/{id}/renew`	تجديد مثل {"days":30}؛ يحتفظ بالترخيص الأصلي.
`POST /licenses/{id}/revoke`	إلغاء؛ جسم الطلب {}.
`GET /products/{id}/public-keys`	اقرأ مفاتيح المنتج العامة دون دخول. ثبّت المفاتيح الموثوقة عند توزيع SDK.
`GET /activations`	اعرض روابط الأجهزة وجلسات التشغيل.

تستخدم الصفحات limit=25&offset=0، limit حتى 100. المعاملات والهياكل الأخرى في ملف OpenAPI؛ راجع موضوع نموذج الترخيص في القائمة الجانبية.

كيف أستدعي بجلسة دخول المتصفح؟

طلبات الكتابة بملفات ارتباط المتصفح تحتاج X-CSRF-Token. اطلب GET /api/v1/auth/csrf ثم ضع data.csrf_token في هذا الرأس. طلبات Bearer Key لا تحتاج CSRF.