TL.HttpClientExtensionsLibrary
0.1.0
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package TL.HttpClientExtensionsLibrary --version 0.1.0
NuGet\Install-Package TL.HttpClientExtensionsLibrary -Version 0.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="TL.HttpClientExtensionsLibrary" Version="0.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="TL.HttpClientExtensionsLibrary" Version="0.1.0" />
<PackageReference Include="TL.HttpClientExtensionsLibrary" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add TL.HttpClientExtensionsLibrary --version 0.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: TL.HttpClientExtensionsLibrary, 0.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package TL.HttpClientExtensionsLibrary@0.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=TL.HttpClientExtensionsLibrary&version=0.1.0
#tool nuget:?package=TL.HttpClientExtensionsLibrary&version=0.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
🌐 TL.HttpClientExtensionsLibrary
O TL.HttpClientExtensionsLibrary é uma biblioteca .NET voltada para simplificar chamadas REST sobre System.Net.Http.HttpClient, adicionando suporte a políticas de retentativa resilientes, tratamento de rate limiting (HTTP 429), upload/download de arquivos e manipulação de autenticação com Bearer Token e JWT.
📦 Instalação
Adicione o pacote ao seu projeto através do .NET CLI:
dotnet add package TL.HttpClientExtensionsLibrary
🚀 Funcionalidades Principais
| Categoria | Métodos Disponíveis | Descrição |
|---|---|---|
| Envio & Respostas JSON | SendJsonAsync<T>(), ReadAsJsonAsync<T>(), PostJsonAsync<T>() |
Serialização e deserialização automática de payloads HTTP. |
| Resiliência & Retry | ExponentialBackoffRetryAsync(), RateLimitRetryAsync(), TimeoutRetryAsync() |
Retentativas com backoff exponencial e respeito a cabeçalhos Retry-After. |
| Autenticação & Tokens | AddBearerToken(token), ExtractClaims(token) |
Injeção de credenciais Bearer e inspeção de claims em tokens JWT. |
| Transferência de Arquivos | UploadFileAsync(), DownloadFileAsync(), GetFileSizeAsync() |
Upload via multipart/form-data e download via streams otimizados. |
| Diagnóstico & Logs | LogRequest(), LogResponse(), LogError() |
Rastreabilidade de chamadas HTTP externas sem vazamento de credenciais. |
💡 Exemplos de Uso
using System.Net.Http;
using HttpClientExtensionsLibrary;
class Program
{
static async Task Main()
{
using var httpClient = new HttpClient();
// 1. Configuração de Bearer Token
httpClient.AddBearerToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
// 2. Envio de Payload com Resposta Tipada
var payload = new { Nome = "Serviço de Cobrança", Ativo = true };
var resposta = await httpClient.SendJsonAsync<ResultadoDto>(
"https://api.empresa.com/servicos",
HttpMethod.Post,
payload
);
// 3. Download Direto de Arquivo
await httpClient.DownloadFileAsync(
"https://api.empresa.com/relatorios/2026-09.pdf",
@"C:\temp\relatorio.pdf"
);
}
}
🏛️ Decisões Arquiteturais e Segurança
Para detalhes sobre a prevenção de reenvio inválido de instâncias HttpRequestMessage, suporte a CancellationToken e proteção contra vazamento de tokens em logs, consulte o documento oficial:
📄 Licença
Distribuído sob a licença MIT.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 is compatible. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net5.0
- Newtonsoft.Json (>= 13.0.3)
- System.IdentityModel.Tokens.Jwt (>= 8.1.2)
-
net6.0
- Newtonsoft.Json (>= 13.0.3)
- System.IdentityModel.Tokens.Jwt (>= 8.1.2)
-
net8.0
- Newtonsoft.Json (>= 13.0.3)
- System.IdentityModel.Tokens.Jwt (>= 8.1.2)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on TL.HttpClientExtensionsLibrary:
| Package | Downloads |
|---|---|
|
TL.ExtensionLibrary.Infrastructure
Clean Architecture Infrastructure metapackage: database querying, resilient HTTP, and assembly scanning extensions, transitively including Application and Domain. |
GitHub repositories
This package is not used by any popular GitHub repositories.