RetailSolutions.Shared.Max 1.3.1387

RetailSolutions.Shared.Max

Biblioteca .NET que fornece abstrações e integração simplificada com a API da Max Sistemas, incluindo gerenciamento automático de autenticação, cache de tokens e configuração de HttpClient.

Características

• 🔐 Autenticação Automática: Gerenciamento automático de tokens de acesso com cache em Redis
• 🌐 HttpClient Configurado: Múltiplos clientes HTTP pré-configurados para diferentes endpoints da API
• ⚡ Cache Inteligente: Cache de tokens em Redis para otimizar performance
• 🔧 Fácil Configuração: Extensões simples para integração com HostApplicationBuilder
• 📝 Logging Integrado: Suporte completo a logging com Serilog

Instalação

Instale o pacote via NuGet:

dotnet add package RetailSolutions.Shared.Max

Ou via Package Manager:

Install-Package RetailSolutions.Shared.Max

Requisitos

• .NET 10.0 ou superior
• Redis (para cache de tokens)
• Credenciais de acesso à API Max Sistemas

Início Rápido

1. Configurar o Redis

Primeiro, configure o Redis no seu projeto. Este pacote utiliza RetailSolutions.Shared.Cache para gerenciar a conexão Redis.

2. Configurar a Aplicação

No seu arquivo Program.cs ou Startup.cs, adicione a configuração:

using RetailSolutions.Shared.Max;

var builder = Host.CreateApplicationBuilder(args);

// Configurar Max Sistemas
builder.Services.Configure<MaxSistemasConfiguration>(builder.Configuration.GetSection("MaxSistemas"));
builder.AddMaxHttpClient();

var host = builder.Build();

3. Configurar appsettings.json

Adicione as configurações no seu appsettings.json:

{
  "MaxSistemas": {
    "BaseUrl": "https://api.maxsistemas.com.br",
    "BaseUrlUnificado": "https://api-unificado.maxsistemas.com.br",
    "BaseUrl04": "https://api04.maxsistemas.com.br",
    "Login": "seu-login",
    "Password": "sua-senha"
  }
}

4. Usar os HttpClientes

O pacote registra automaticamente vários clientes HTTP nomeados que você pode injetar:

public class MeuServico
{
    private readonly IHttpClientFactory _httpClientFactory;
    
    public MeuServico(IHttpClientFactory httpClientFactory)
    {
        _httpClientFactory = httpClientFactory;
    }
    
    public async Task<string> ObterDadosAsync()
    {
        var client = _httpClientFactory.CreateClient(MaxConstants.MAX_SISTEMAS_API);
        var response = await client.GetAsync("/api/v1/dados");
        return await response.Content.ReadAsStringAsync();
    }
}

Clientes HTTP Disponíveis

O pacote registra os seguintes clientes HTTP nomeados:

• MaxSistemas-API: Cliente principal para a API Max Sistemas
• MaxSistemas-API-Unificado: Cliente para a API Unificada
• MaxSistemas-API-04: Cliente para a API versão 04
• MaxSistemas-TOKEN: Cliente para autenticação (sem handler de autorização)

Todos os clientes de API incluem automaticamente o header de autorização Bearer token.

Gerenciamento de Tokens

O MaxTokenService gerencia automaticamente os tokens de acesso:

• Tokens são armazenados em cache no Redis
• Tokens são renovados automaticamente quando expiram
• Cache é compartilhado entre instâncias da aplicação

Usar o Token Service Diretamente

public class MeuServico
{
    private readonly ITokenService _tokenService;
    
    public MeuServico(ITokenService tokenService)
    {
        _tokenService = tokenService;
    }
    
    public async Task<string> ObterTokenAsync()
    {
        return await _tokenService.GetAccessTokenAsync();
    }
}

Exemplo Completo

using Microsoft.Extensions.Options;
using RetailSolutions.Shared.Max;

var builder = Host.CreateApplicationBuilder(args);

// Configurar Max Sistemas
builder.Services.Configure<MaxSistemasConfiguration>(
    builder.Configuration.GetSection("MaxSistemas")
);

// Adicionar serviços Max
builder.AddMaxHttpClient();

// Registrar seu serviço
builder.Services.AddScoped<MeuServico>();

var host = builder.Build();

// Usar o serviço
var servico = host.Services.GetRequiredService<MeuServico>();
var dados = await servico.ObterDadosAsync();

Configuração Avançada

Personalizar Timeout de Conexão

Os clientes HTTP são configurados com:

• Pool de conexões com lifetime de 15 minutos
• Validação de certificado SSL customizada
• Handler lifetime infinito para reutilização de conexões

Logging

O pacote utiliza ILogger para registrar:

• Requisições de autenticação
• Respostas da API
• Erros e exceções

Configure seu logger preferido (Serilog, NLog, etc.) normalmente.

Dependências

• Microsoft.Extensions.Http (10.0.1)
• Microsoft.Extensions.Logging (10.0.1)
• Microsoft.Extensions.Options (10.0.1)
• Newtonsoft.Json (13.0.4)
• Serilog (4.3.0)
• StackExchange.Redis (2.10.1)
• RetailSolutions.Shared.Cache (1.2.73)

Suporte e Feedback

• Website: https://www.retailsolutions.com.br/
• Issues: Reporte problemas ou sugestões através dos canais oficiais da Retail Solutions

Licença

Copyright © Retail Solutions. Todos os direitos reservados.

Tags

Gemco, RetailSolutions, Max Sistemas