Kaz.Http 1.0.0-beta

Kaz.Http

A resilient HTTP client for .NET 6+ with retry, caching, rate limiting, circuit breaker, bulkhead isolation, fallback routing, telemetry, and request signing.

Installation

dotnet add package Kaz.Http

Install-Package Kaz.Http

What's Inside

How to use

GET

var response = await Client.GetAsync<WeatherData>("https://api.example.com/weather");

if (response.IsSuccess)
    Console.WriteLine(response.Data);

// Authenticated
var response = await Client.GetAsync<WeatherData>("https://api.example.com/weather", apiKey);

POST

var response = await Client.PostAsync<CreateUserRequest, UserResponse>(
    "https://api.example.com/users",
    new CreateUserRequest { Name = "Alice" });

// Authenticated
var response = await Client.PostAsync<CreateUserRequest, UserResponse>(
    "https://api.example.com/users", apiKey,
    new CreateUserRequest { Name = "Alice" });

PUT

var response = await Client.PutAsync<UpdateUserRequest, UserResponse>(
    "https://api.example.com/users/1",
    new UpdateUserRequest { Name = "Bob" });

PATCH

var response = await Client.PatchAsync<PatchRequest, UserResponse>(
    "https://api.example.com/users/1",
    new PatchRequest { Name = "Bob" });

DELETE

var response = await Client.DeleteAsync<DeleteResponse>("https://api.example.com/users/1");

HEAD

// Returns headers only
var response = await Client.HeadAsync<object>("https://api.example.com/users");

if (response.IsSuccess)
    Console.WriteLine(response.Headers);

Configuration

Retry

Client.RetryCount = 3;     // default: 3
Client.RetryDelay = 1000;  // initial delay in ms, doubles on each retry (default: 1000)

Circuit Breaker

Client.CircuitBreakerFailureThreshold = 3;                        // default: 3
Client.CircuitBreakerRecoveryTimeout = TimeSpan.FromSeconds(30);  // default: 30s

Rate Limiting

Client.RateLimiterMaxRequests = 100;                 // default: 100
Client.RateLimiterPeriod = TimeSpan.FromSeconds(1);  // default: 1s

Timeout

Client.SetTimeout("https://api.example.com", TimeSpan.FromSeconds(10));

Bulkhead

Client.SetBulkhead("https://api.example.com", maxConcurrent: 5);

Fallback URL

Client.RegisterFallbackUrl(
    "https://api.example.com/data",
    "https://backup.example.com/data");

Request Signing

Client.SigningKey = "your-secret-key";

Response Contracts

Client.AddContract<UserResponse>(user =>
    user.Id > 0 ? null : "Invalid user ID.");

Default Headers

Client.AddDefaultHeader("X-App-Version", "2.0.0");

Telemetry

Console.WriteLine(Client.Telemetry.TotalRequests);  // total requests sent
Console.WriteLine(Client.Telemetry.Errors);         // total failed requests
Console.WriteLine(Client.Telemetry.Duration);       // last request duration in ms

License

This project is distributed under the MIT License — free for personal and commercial use.

Contact