JSolutionss.API.JSSHttpClient 1.1.12

Acerca

Librería para encapsular llamadas HTTP a APIs REST usando HttpClientFactory, con soporte para:

GET / POST

✔ Body y headers dinámicos ✔ Token Bearer ✔ Timeout por request ✔ Reintentos controlados ✔ Manejo de errores estandarizado (JssApiException) ✔ Uso directo o vía Fluent Builder

Configuración básica

Configurar en Program.cs las siguientes lineas de codigo.

builder.Services.AddHttpClient();
builder.Services.AddSingleton<IHttpServiceFactory, HttpServiceFactory>();

Uso básico (sin reintentos)

Ejemplo de uso desde un servicio de aplicación:

public class ServiceSample : IServiceSample
{
    private readonly IHttpServiceFactory _httpServiceFactory;

    public ServiceSample(IHttpServiceFactory httpServiceFactory)
    {
        _httpServiceFactory = httpServiceFactory;
    }

    public async Task<IEnumerable<ItemModel>> GetAll(FilterModel filter)
    {
        return await _httpServiceFactory.SendAsync<IEnumerable<ItemModel>>(
            clientName: "default",
            method: HttpMethod.Post,
            relativeUrl: "api/items/get-all",
            body: filter,
            headers: null,
            token: null,
            timeoutSeconds: 15,
            retryCount: 0,              // sin reintentos
            retryDelay: TimeSpan.Zero,
            ct: CancellationToken.None
        );
    }
}

Uso con GET

var result = await _httpServiceFactory.SendAsync<List<ItemModel>>(
    clientName: "default",
    method: HttpMethod.Get,
    relativeUrl: "api/items?id=10&activo=true",
    body: null,
    headers: null,
    token: token,
    timeoutSeconds: 10,
    retryCount: 0,
    retryDelay: TimeSpan.Zero,
    ct: ct
);

Uso con reintentos (RESILIENCIA)

Los reintentos no son automáticos, se habilitan explícitamente.

var result = await _httpServiceFactory.SendAsync<MyResponseDto>(
    clientName: "ApiClientes",
    method: HttpMethod.Post,
    relativeUrl: "clientes",
    body: new ClienteRequest { Id = 10 },
    headers: null,
    token: "jwt-token-aqui",
    timeoutSeconds: 20,
    retryCount: 3,
    retryDelay: TimeSpan.FromMilliseconds(500),
    ct: CancellationToken.None
);

Uso con HttpClient nombrado

Configurar en Program.cs las siguientes lineas de codigo.

builder.Services.AddHttpClient("NamedHttpClient")
    .SetHandlerLifetime(TimeSpan.FromMinutes(5))
    .ConfigureHttpMessageHandlerBuilder(builder =>
    {
        builder.PrimaryHandler = new HttpClientHandler
        {
            ServerCertificateCustomValidationCallback = (m, c, ch, e) => true
        };
    });

builder.Services.AddScoped<IHttpServiceFactory, HttpServiceFactory>();

Uso

var result = await _httpServiceFactory.SendAsync<MyResponseDto>(
    clientName: "NamedHttpClient",
    method: HttpMethod.Post,
    relativeUrl: "api/datos",
    body: new { id = 5 },
    headers: null,
    token: "jwt-token-aqui",
    timeoutSeconds: 15,
    retryCount: 2,
    retryDelay: TimeSpan.FromMilliseconds(300),
    ct: CancellationToken.None
);

Manejo de errores

Todos los errores HTTP y de infraestructura lanzan:

JssApiException

Incluye:

Nombre del cliente HTTP

URL

Método HTTP

StatusCode (si aplica)

Body de error (si existe)

Excepción original

try
{
    await service.CallApi();
}
catch (JssApiException ex)
{
    // logging centralizado
    // ex.ClientName
    // ex.Url
    // ex.Method
    // ex.StatusCode
    // ex.ResponseBody
}

Fluent Builder (opcional)

Para llamadas más expresivas:

var result = await http
    .Client("ApiClientes")
    .Post("clientes")
    .WithParams(new ClienteRequest { Id = 10 })
    .WithRetry(3, 500)
    .SendAsync<ClienteDto>();

Principios de diseño

El consumidor no crea HttpRequestMessage

La infraestructura maneja: ✔ construcción del request, ✔ reintentos, ✔ timeouts, ✔ errores, ✔ Código limpio, testeable y extensible

Principios de diseño

Reintentos solo en operaciones idempotentes ✔ No usar retry en POST no idempotentes ✔ Centralizar logging sobre JssApiException ✔ Preferir HttpClient nombrados para APIs externas