LeadSoft® Brasil Api Integration Adapter

LeadSoft.Adapter.BrasilAPI

Adapter .NET para integrar com serviços públicos da BrasilAPI (https://brasilapi.com.br/). Fornece uma camada simples e testável para consumir endpoints públicos da BrasilAPI (ex.: Bancos, CNPJ, Feriados, etc.), encapsulando chamadas HTTP, mapeamento de modelos e tratamento de erros de forma consistente para aplicações .NET 9.

Este pacote é um tributo independente e não é afiliado oficialmente à BrasilAPI. Somos gratos pela iniciativa de disponibilizar dados públicos de forma aberta. Conheça o projeto oficial e utilizando este pacote, você concorda automaticamente com os termos de uso da BrasilAPI.

Principais características

• Compatível com .NET 9.0.
• Chamadas assíncronas com async/await.
• Integração simples com Dependency Injection (DI) do .NET.
• Projetado para ser testável (injeção de HttpClient, separação de responsabilidades).
• Tratamento centralizado de erros e respostas HTTP.
• Extensível para políticas de resiliência (ex.: Polly).

Instalação

Pelo CLI do .NET:

dotnet add package LeadSoft.Adapter.BrasilAPI

Ou via NuGet Package Manager no Visual Studio (pesquise por LeadSoft.Adapter.BrasilAPI).

Uso básico (exemplo)

Abaixo um exemplo genérico de como registrar e usar o adapter em uma aplicação ASP.NET Core / Console com DI e IHttpClientFactory.

// Program.cs (exemplo)
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using LeadSoft.Adapter.BrasilAPI;

WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

//...
builder.Logging.AddBrasilApi(); //builder.Logging.AddBrasilApi(true); para injeção em singleton
//...

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

Exemplo de chamada (pseudocódigo; adapte para os tipos reais do pacote):

string cnpj = "38.0443.762/0001-48";
DTOBrasilApiCnpjResponse dto = await new BrasilApi().GetCnpjInfoAsync(cnpj);

Configuração recomendada

• Use IHttpClientFactory (ex.: services.AddHttpClient(...)) para gerenciar instâncias de HttpClient de forma segura.
• Configure timeouts e cabeçalhos (User-Agent) apropriados.
• Adicione políticas de resiliência com Polly (retries exponenciais, circuit-breaker) para lidar com intermitências da rede.