LuckyCodeIntegration 2.0.26

LuckyCodeIntegration

مكتبة .NET تساعدك على التكامل بسرعة مع واجهات Redeemly/LuckyCode عبر HttpClient مع دعم Dependency Injection.

المتطلبات

• .NET 8.0+

التثبيت

عبر NuGet

dotnet add package LuckyCodeIntegration

الإعداد (Dependency Injection)

أضف الخدمة عبر الامتداد AddIntegrationService ثم مرّر إعدادات الاتصال.

Program.cs

using LuckyCodeLibrary.IntegrationHelper.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddIntegrationService(options =>
{
    options.BaseUrl = "https://api.example.com";
    options.AccessCredential.ApiKey = "YOUR_API_KEY";
    options.AccessCredential.ClientId = "YOUR_CLIENT_ID";
});

var app = builder.Build();
app.Run();

الاستخدام

بعد التسجيل في DI، يمكنك حقن ILuckyCodeServices واستخدامه.

مثال: Pull ثم Reveal ثم Redeem

using LuckyCodeLibrary.IntegrationHelper.Services;

public class LuckyCodeController
{
    private readonly ILuckyCodeServices _luckyCode;

    public LuckyCodeController(ILuckyCodeServices luckyCode)
    {
        _luckyCode = luckyCode;
    }

    public async Task UseLuckyCodeAsync()
    {
        var pull = await _luckyCode.PullCode(new PullCodeRequest
        {
            // عبّئ الخصائص المطلوبة حسب الموديل لديك
        });

        var reveal = await _luckyCode.RevealCode(new RevealCodeRequest
        {
            // عبّئ الخصائص المطلوبة حسب الموديل لديك
        });

        var redeem = await _luckyCode.RedeemCode(new RedeemCodeRequest
        {
            // عبّئ الخصائص المطلوبة حسب الموديل لديك
        });
    }
}

الدوال المتاحة (ILuckyCodeServices)

• GetToken(CredentialModel credential)
• GetToken()
• PullCode(PullCodeRequest dto)
• RevealCode(RevealCodeRequest dto)
• RedeemCode(RedeemCodeRequest dto)
• MultiPull(PullCodeRequest dto)
• MultiPullThenReveal(PullCodeRequest dto)
• CheckSerialCode(string serialCode)
• GetCustomersLog(CustomerPakageLogQuery queryDto)
• EnsureValidToken()

الإعدادات (ConnectionSettings)

• BaseUrl: رابط الـ API الأساسي.
• AccessCredential.ApiKey: مفتاح الوصول.
• AccessCredential.ClientId: معرّف العميل.

ملاحظات

• يتم تخزين التوكن داخليًا (caching) مع إعادة تحديث تلقائية قبل انتهاء الصلاحية.
• يتم حقن HttpClient عبر AddHttpClient.

الترخيص

MIT