LuckyCodeIntegration 2.0.16

🧩 LuckyCodeIntegration (.NET)

A modern, secure, and plug-and-play integration package for LuckyCode API

🚀 Overview

The LuckyCodeIntegration package provides an instant and secure way to integrate your .NET applications with the LuckyCode API.
It handles token authentication, API communication, and configuration automatically — allowing developers to focus on business logic instead of setup.

✨ Features

• 🔐 Built-in Authentication: Auto token retrieval & refresh via EnsureValidToken()
• ⚙️ Simple Configuration: Reads settings directly from appsettings.json
• 🧱 Dependency Injection Ready: Uses IHttpClientFactory and IOptions<T>
• 🔄 Automatic Token Caching: Keeps connections secure and efficient
• 🧰 Full API Coverage: Supports Pull, Reveal, Redeem, Multi-Pull, and Check Serial Code
• 🧩 Prebuilt Controller: Optional LuckyCodeController for rapid testing

📦 Installation

Install via NuGet Package Manager or CLI:

dotnet add package LuckyCodeIntegration --version 2.0.13

⚙️ Configuration

appsettings.json

"LuckyCode": {
  "BaseUrl": "https://api.redeemly.com",
  "AccessCredential": {
    "ApiKey": "your-api-key",
    "ClientId": "your-client-id"
  }
}

Program.cs

using LuckyCodeLibrary.IntegrationHelper.Extensions;

builder.Services.AddIntegrationService(
    builder.Configuration.GetSection("LuckyCode").Bind);

🔑 Example Usage

using LuckyCodeLibrary.IntegrationHelper.Services;
using LuckyCodeLibrary.IntegrationHelper.Models;

public class Example
{
    private readonly ILuckyCodeServices _luckyCodeServices;

    public Example(ILuckyCodeServices luckyCodeServices)
    {
        _luckyCodeServices = luckyCodeServices;
    }

    public async Task RunAsync()
    {
        var token = await _luckyCodeServices.EnsureValidToken();

        var request = new PullCodeRequest
        {
            CustomerRef = "CUST-12345",
            Quantity = 1
        };

        var result = await _luckyCodeServices.PullCode(request, token);

        if (result.Success)
            Console.WriteLine($"Code Pulled: {result.Data.Code}");
        else
            Console.WriteLine($"Error: {result.Message}");
    }
}

🧩 Available Endpoints

🧠 Internal Logic

• EnsureValidToken()
  • Fetches a bearer token from LuckyCode API using API Key & Client ID.
  • Caches it in memory and refreshes automatically before expiration.

✅ Client Integration Demo

A sample .NET project was built to simulate a real client using this package.
The demo successfully validated:

• Configuration binding
• Token management
• Secure API communication
• Fast setup (under 10 minutes)

📄 License

Licensed under the MIT License — free for commercial and private use.