البدء مع API Entitlement في C#/.NET

في هذا المقال، سنتناول العملية خطوة بخطوة لدمج API Entitlement من Autodesk في إضافة AutoCAD الخاصة بك مع C#/.NET. ستتعلم كيفية تثبيت SDK وتكوين العميل وإجراء التحقق من الترخيص عند بدء التشغيل.

تدفق الإعداد: تثبيت الحزمة ← تكوين العميل ← التحقق من الترخيص

المتطلبات المسبقة

Visual Studio 2022 أو أحدث
.NET Framework 4.8 (أو .NET 6+ للإضافات .NET Core)
ملف license.token صالح (من حساب Autodesk الخاص بك)
حزمة NuGet: Autodesk.EntitlementApi

1. تثبيت SDK الخاص بـ API Entitlement

Install-Package Autodesk.EntitlementApi -Version 1.0.0

2. تكوين EntitlementApiClient

في ملف Plugin.cs الخاص بك (أو فئة الدخول الرئيسية)، قم بتهيئة العميل مع URL الأساسي لـ API وبيانات الاعتماد الخاصة بك:

plugin.cs

using Autodesk.Entitlement;

public class Plugin : IExtensionApplication
{
    private EntitlementApiClient _entitlementClient;

    public void Initialize(IExtensionApplication app)
    {
        var baseUrl = "https://api.autodesk.com/entitlement/v1";
        var apiKey  = Environment.GetEnvironmentVariable("ENTITLEMENT_API_KEY");
        _entitlementClient = new EntitlementApiClient(baseUrl, apiKey);

        ValidateLicense();
    }

    public void Terminate() { /* تنظيف */ }

    private void ValidateLicense()
    {
        var token = File.ReadAllText("license.token");
        var response = _entitlementClient.ValidateTokenAsync(token)
                             .GetAwaiter().GetResult();

        if (!response.IsValid)
            throw new UnauthorizedAccessException("فشل في التحقق من الترخيص: " + response.Message);
    }
}

3. التحقق والتفعيل

بعد التحقق من الرمز المميز، يمكنك اختيارياً تفعيل مقعد عائم:

Plugin.cs

// تفعيل ترخيص عائم للجهاز الحالي
var machineId = Environment.MachineName;
var activation = _entitlementClient.ActivateAsync(token, machineId)
                        .GetAwaiter().GetResult();
if (!activation.Success)
    Debug.WriteLine("تحذير التفعيل: " + activation.Message);

4. معالجة الأخطاء والتسجيل

قم بتغليف استدعاءاتك في try-catch للتعامل بلطف مع مشاكل الشبكة أو أخطاء API:

try
{
    ValidateLicense();
}
catch (Exception ex)
{
    Debug.WriteError($"خطأ في الاستحقاق: {ex.Message}");
    // اختيارياً تعطيل ميزات الإضافة أو مطالبة المستخدم
}

⚠️ نصيحة: استخدم HttpClientFactory وسياسات إعادة المحاولة (مثل Polly) لجعل استدعاءات الاستحقاق مقاومة للأعطال المؤقتة.

مقدمة في API Entitlement

نظرة عامة عالية المستوى والمفاهيم الأساسية.

إعداد بيانات الاختبار

تصميم سجلات استحقاق واقعية للاختبار.

PDF الرسمي لـ API Entitlement

مرجع Autodesk الرسمي لـ API الاستحقاق لتطبيقات سطح المكتب.

الخطوات التالية

في المقال رقم 3، سنستكشف كيفية إنشاء بيانات اختبار على مستوى احترافي وأتمتة اختبار سيناريوهات الترخيص في خط أنابيب CI الخاص بك.