alexbypa27/CSharpEssentials.HttpHelperv2.0.2
.NET 8.0.NET 9.0
package to help manage of httpHelper
Get Started
$ dotnet add package CSharpEssentials.HttpHelperReadme
🔗 CSharpEssentials.HttpHelper
A powerful and fluent HTTP helper for .NET built on top of HttpClientFactory, designed to simplify REST API calls with built-in support for retry policies, rate limiting, logging, timeouts, and dynamic configuration from appsettings.
🚀 Features
✅ Fully configurable via appsettings.httpHelper.json
✅ Integrated with HttpClientFactory
✅ Automatic retry with Polly
✅ Rate Limiting using SlidingWindowRateLimiter
✅ Support for FormUrlEncodedContent and JSON
✅ Custom event-based logging
✅ Fluent API: .addTimeout(), .addRetryCondition(), .addHeaders(), etc.
🛠️ Setup
1. In Program.cs:
builder.Services.AddHttpClients(builder.Configuration);
2. Create or extend appsettings.httpHelper.json:
{
"HttpClientOptions": [
{
"Name": "Test1",
"RateLimitOptions": {
"AutoReplenishment": true,
"PermitLimit": 1,
"QueueLimit": 0,
"Window": "00:00:15",
"SegmentsPerWindow": 1
}
}
]
}
🧩 Usage Example
var httpsClientHelper = (httpsClientHelper)factory.CreateOrGet("Test1");
var response = await httpsClientHelper
.addTimeout(TimeSpan.FromSeconds(30))
.AddRequestAction(async (req, res, retry, ts) => {
Console.WriteLine($"[{req.Method}] {req.RequestUri} → {(int)res.StatusCode} | RETRY: {retry} | RL Wait: {ts}");
})
.addRetryCondition(
res => res.StatusCode != HttpStatusCode.OK,
retryCount: 3,
backoffFactor: 2
)
.SendAsync(
"https://example.com/api",
HttpMethod.Get,
null,
new NoBodyContentBuilder()
);
string body = await response.Content.ReadAsStringAsync();