License8.Lib.Service 0.81.0

License8 Client Library

A .NET client library for the License8 API, providing simple and type-safe access to license management, device registration, and JWT authentication.

Installation

dotnet add package License8.Lib.Service

Quick Start

using License8.Lib.Service;

// Initialize the client
var client = new License8Client(
    baseUrl: "https://api.license8.com/v1/licenses",
    apiKey: "your-api-key",
    licenseeAppKey: "your-licensee-app-key"
);

// Authenticate with a license key
var authResponse = await client.AuthenticateWithLicenseKeyAsync("XXXXX-XXXXX-XXXXX-XXXXX");

if (authResponse.IsSuccess)
{
    var jwt = authResponse.Data!.Jwt!;
    Console.WriteLine($"Authenticated! License: {authResponse.Data.LicenseID}");

    // Register a device
    var deviceResponse = await client.RegisterNewDeviceAsync(
        jwt: jwt,
        deviceID: "unique-device-id",
        deviceLabel: "User's Laptop",
        machineName: Environment.MachineName
    );

    // Validate token
    var validation = await client.ValidateTokenAsync(jwt);
    Console.WriteLine($"Token valid: {validation.Data?.IsValid}");

    // List registered devices
    var devices = await client.ListRegisteredDevicesAsync(jwt);
    Console.WriteLine($"Total devices: {devices.Data?.Count ?? 0}");
}

// Server-side operations require appSecret
var appSecret = "your-app-secret"; // Fetch from secure config
var licenseDetails = await client.GetLicenseDetailsAsync(appSecret, "license-id");

API Methods

Methods return ApiResponse<T> with IsSuccess, Data, and Error properties unless noted otherwise.

System

License Management (requires appSecret)

Authentication

Token Operations (requires jwt)

Device Management (requires jwt)

Features

• License Management: Create, issue, revoke, and retrieve license details
• Expiration & Limits: Set or update license expiration dates and max device limits
• Device Registration: Register, list, and disable devices for licensed users
• JWT Authentication: Authenticate, validate, and renew tokens
• Trial Licenses: Issue time-limited trial licenses
• Type-Safe: Strongly-typed request/response models with ApiResponse<T> wrapper
• Async/Await: Full async support with cancellation tokens
• Response Logging: Optional built-in request/response logging via enableLog constructor parameter

Documentation

For complete API documentation, visit https://license8.com/docs

License

MIT