Client API

TurboHTTP provides a simple, familiar interface for making HTTP requests.

SendAsync

The standard way to send a request:

var client = factory.CreateClient("my-api");
var request = new HttpRequestMessage(HttpMethod.Get, "/users/123");
var response = await client.SendAsync(request, ct);

Console.WriteLine(response.StatusCode);

SendAsync behaves like HttpClient.SendAsync:

• Takes an HttpRequestMessage
• Returns a Task<HttpResponseMessage>
• Supports CancellationToken for cancellation
• Respects timeouts in TurboClientOptions

All pipeline features (cookies, caching, retries, redirects) apply automatically. You don't think about them.

Channel API

For high-throughput scenarios where you're sending many requests and processing responses in a producer/consumer pattern:

var client = factory.CreateClient("my-api");
var writer = client.Requests;
var reader = client.Responses;

// Producer task: send many requests
_ = Task.Run(async () =>
{
    for (int i = 0; i < 1000; i++)
    {
        var req = new HttpRequestMessage(HttpMethod.Get, $"/item/{i}");
        await writer.WriteAsync(req);
    }
    writer.TryComplete();
});

// Consumer task: process responses as they arrive
await foreach (var response in reader.ReadAllAsync())
{
    // Process response
    Console.WriteLine(response.StatusCode);
}

The channel API provides backpressure — if the producer sends too fast, WriteAsync will wait until the consumer has processed responses.

Configuration

Transport options are set via TurboClientOptions at registration time. Request defaults like HTTP version and headers are set on the client instance:

// Register via DI
services.AddTurboHttpClient("my-api", options =>
{
    options.BaseAddress = new Uri("https://api.example.com");
});

// Resolve and configure the client instance
var client = factory.CreateClient("my-api");
client.DefaultRequestVersion = HttpVersion.Version20;  // Force HTTP/2
client.DefaultRequestHeaders.Add("User-Agent", "MyApp/1.0");
client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

See Configuration Guide for full options.