A modern, high-performance HTTP client library for .NET with fluent API, proxy support, retry policies, JWT authentication, request queuing, and advanced parsing features.
$ dotnet add package DevBase.NetA modern, high-performance HTTP client library for .NET 9.0 with fluent API, SOCKS5 proxy support, retry policies, and advanced response parsing.
dotnet add package DevBase.Net
using DevBase.Net.Core;
// Simple GET request
var response = await new Request("https://api.example.com/data").SendAsync();
string content = await response.GetStringAsync();
// POST with JSON
var response = await new Request("https://api.example.com/users")
.AsPost()
.WithJsonBody(new { name = "John" })
.SendAsync();
// GET (default)
var response = await new Request(url).SendAsync();
// POST
var response = await new Request(url).AsPost().WithJsonBody(data).SendAsync();
// PUT
var response = await new Request(url).AsPut().WithJsonBody(data).SendAsync();
// DELETE
var response = await new Request(url).AsDelete().SendAsync();
var response = await new Request(url)
.WithHeader("Authorization", "Bearer token")
.WithHeader("X-Custom", "value")
.SendAsync();
// JSON
var data = await response.ParseJsonAsync<MyType>();
// JSON Path
var value = await response.ParseJsonPathAsync<string>("$.user.name");
// HTML
var doc = await response.ParseHtmlAsync();
// String
var text = await response.GetStringAsync();
using DevBase.Net.Proxy;
using DevBase.Net.Proxy.Enums;
// HTTP Proxy
var httpProxy = new ProxyInfo("proxy.example.com", 8080, EnumProxyType.Http);
// SOCKS5 Proxy with authentication
var socks5Proxy = new ProxyInfo("proxy.example.com", 1080, "user", "pass", EnumProxyType.Socks5);
// SOCKS5h Proxy (remote DNS - more private)
var socks5hProxy = new ProxyInfo("proxy.example.com", 1080, EnumProxyType.Socks5h);
// Parse from string
var proxy = ProxyInfo.Parse("socks5://user:pass@proxy.example.com:1080");
// Use with request
var response = await new Request(url)
.WithProxy(proxy)
.SendAsync();using DevBase.Net.Core;
using DevBase.Net.Proxy;
var proxiedBatch = new ProxiedBatchRequests()
.WithRateLimit(5)
.WithProxy("socks5://proxy1.example.com:1080")
.WithProxy("socks5://proxy2.example.com:1080")
.WithRoundRobinRotation() // Or: WithRandomRotation(), WithLeastFailuresRotation()
.OnProxyFailure((proxy, ctx) => Console.WriteLine($"Proxy {proxy.Key} failed"));
var batch = proxiedBatch.CreateBatch("scraping");
for (int i = 0; i < 100; i++)
batch.Enqueue($"https://target.com/page/{i}");
var responses = await proxiedBatch.ExecuteAllAsync();var response = await new Request(url)
.WithRetryPolicy(RetryPolicy.Exponential(maxRetries: 3))
.SendAsync();using DevBase.Net.Configuration;
using DevBase.Net.Configuration.Enums;
// Simple Chrome emulation with default settings
var response = await new Request("https://protected-site.com")
.WithScrapingBypass(ScrapingBypassConfig.Default)
.SendAsync();
// Custom configuration
var config = new ScrapingBypassConfig
{
Enabled = true,
BrowserProfile = EnumBrowserProfile.Chrome,
RefererStrategy = EnumRefererStrategy.SearchEngine
};
var response = await new Request("https://target-site.com")
.WithScrapingBypass(config)
.SendAsync();
// User headers always take priority
var response = await new Request("https://api.example.com")
.WithScrapingBypass(ScrapingBypassConfig.Default)
.WithUserAgent("MyCustomBot/1.0") // Overrides Chrome user agent
.SendAsync();Available Browser Profiles:
Chrome - Emulates Google Chrome with client hintsFirefox - Emulates Mozilla FirefoxEdge - Emulates Microsoft EdgeSafari - Emulates Apple SafariReferer Strategies:
None - No referer headerPreviousUrl - Use previous URL (for sequential scraping)BaseHost - Use base host URLSearchEngine - Random search engine URLusing DevBase.Net.Core;
// Process many requests with controlled concurrency
var batchRequests = new BatchRequests()
.WithRateLimit(3) // 3 concurrent requests per second
.WithCookiePersistence()
.OnResponse(r => Console.WriteLine($"Status: {r.StatusCode}"))
.OnProgress(p => Console.WriteLine($"{p.PercentComplete:F1}% complete"));
// Create batches
var batch = batchRequests.CreateBatch("api-calls");
for (int i = 0; i < 100; i++)
batch.Enqueue($"https://api.example.com/item/{i}");
// Execute - sends 3 requests concurrently per second
var responses = await batchRequests.ExecuteAllAsync();
// Or stream results
await foreach (var response in batchRequests.ExecuteAllAsyncEnumerable())
{
// Process as they complete
}// Configure connection pool for high throughput
var response = await new Request("https://api.example.com")
.WithConnectionPool(
maxConnectionsPerServer: 1000,
connectionLifetime: TimeSpan.FromMinutes(10),
connectionIdleTimeout: TimeSpan.FromMinutes(5))
.WithConnectTimeout(TimeSpan.FromSeconds(15))
.SendAsync();
// Quick optimization presets
var response = await new Request("https://api.example.com")
.OptimizeForThroughput() // High-volume operations (uses HTTP/2, 1000 connections)
.SendAsync();
var response = await new Request("https://api.example.com")
.OptimizeForLatency() // Low-latency operations (TCP_NODELAY, HTTP/2)
.SendAsync();// HTTP/2 (recommended for high throughput)
var response = await new Request(url).AsHttp2().SendAsync();
// HTTP/1.1 (legacy compatibility)
var response = await new Request(url).AsHttp1().SendAsync();
// HTTP/3 (QUIC - experimental)
var response = await new Request(url).AsHttp3().SendAsync();// Enable TCP_NODELAY for lower latency
var response = await new Request(url)
.WithTcpNoDelay(true)
.SendAsync();
// Configure HTTP/2 keep-alive pings
var response = await new Request(url)
.WithKeepAlivePing(TimeSpan.FromSeconds(30), TimeSpan.FromSeconds(10))
.SendAsync();
// Enable multiple HTTP/2 connections per server
var response = await new Request(url)
.WithMultipleHttp2Connections(true)
.SendAsync();// Configure global defaults for all requests
Request.ConfigureConnectionPool(
maxConnections: 1000,
connectionLifetime: TimeSpan.FromMinutes(10),
connectionIdleTimeout: TimeSpan.FromMinutes(5),
connectTimeout: TimeSpan.FromSeconds(30),
enableMultipleHttp2: true);
// Clear all pooled connections
Request.ClearClientPool();HttpToSocks5Proxy based on MihaZupan/HttpToSocks5Proxy (MIT License).
MIT License