Binom.ApiManagerClient 1.0.0

Binom.ApiManagerClient

Binom.ApiManagerClient — это клиентская библиотека .NET для простой и безопасной интеграции с сервером лицензирования WooCommerce API Manager. Она инкапсулирует логику HTTP-запросов, предоставляет удобные методы для управления жизненным циклом лицензии и реализует современные паттерны для защиты вашего программного обеспечения.

Основные возможности

• 🔐 Управление ключами: Безопасное персистентное хранение и управление API-ключами на локальной машине с помощью KeyManager.
• 🚀 Полный цикл лицензирования: Поддержка всех основных операций: активация, деактивация, проверка статуса и верификация ключа.
• 🛡️ Паттерн защищенного выполнения: Используйте ExecuteLicensedActionAsync для выполнения кода, зависящего от лицензии, что значительно усложняет обход защиты путем декомпиляции.
• 🔔 Реактивная система событий: Подписывайтесь на события StatusChanged, ExpirationAlert и UpdateAvailable для создания отзывчивого UI, который реагирует на изменения состояния лицензии в реальном времени.
• 🔄 Проверка обновлений: Встроенный механизм для проверки наличия новых версий вашего продукта.
• ⚙️ Автоматическое определение продукта: Библиотека автоматически находит нужный продукт из списка, связанного с API-ключом.

Быстрый старт

Ниже приведен базовый пример, демонстрирующий основной сценарий интеграции библиотеки в ваше приложение.

using Binom.ApiManagerClient;
using Binom.ApiManagerClient.Enums;
using Binom.ApiManagerClient.Models;

public class AppLicenseController
{
    private LicenseManager _licenseManager;
    private KeyManager _keyManager;

    public async Task Initialize()
    {
        // 1. Инициализация KeyManager для хранения ключей
        string storagePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "YourAppName");
        _keyManager = await KeyManager.CreateAsync(storagePath);
        
        var keyHolder = _keyManager.GetKeyHolder("YOUR_PRODUCT_NAME");
        string apiKey = keyHolder?.ApiKey ?? "YOUR_DEFAULT_API_KEY";

        // 2. Инициализация LicenseManager
        _licenseManager = new LicenseManager(
            apiKey, 
            new[] { "YOUR_PRODUCT_NAME" }, 
            "https://your-woocommerce-server.com/"
        );

        // 3. Подписка на события для обновления UI
        _licenseManager.StatusChanged += OnLicenseStatusChanged;
        _licenseManager.ExpirationAlert += OnLicenseExpirationAlert;

        // 4. Запуск основной логики через безопасный метод
        await _licenseManager.ExecuteLicensedActionAsync(
            licensedAction: async () => {
                Console.WriteLine("Лицензия активна. Запускаем полный функционал.");
                // await RunFullFeaturedMode();
            },
            unlicensedAction: () => {
                Console.WriteLine("Лицензия неактивна или недействительна. Запускаем демо-режим.");
                // RunDemoMode();
                return Task.CompletedTask;
            }
        );
    }

    private void OnLicenseStatusChanged(LicenseStatus status)
    {
        Console.WriteLine($"Статус лицензии изменился: {status}");
        // Обновите ваш UI здесь
    }

    private void OnLicenseExpirationAlert(DateTime expirationDate)
    {
        Console.WriteLine($"Внимание! Срок действия вашей лицензии истекает {expirationDate:D}.");
        // Покажите уведомление пользователю
    }
}

Документация

• Руководство по интеграции: Для получения подробной информации о всех методах, событиях и лучших практиках см. Руководство по интеграции Binom.ApiManagerClient.
• Справочник по API: Для получения подробной информации о конечных точках сервера WooCommerce API Manager см. Справочник по API.

Лицензия

Этот проект распространяется под лицензией MIT.