Fluent.Client 1.2.0

Fluent.Client

Created in Poland by Leszek Pomianowski and open-source community.
A chainable HTTP client wrapper for .NET that reduces the boilerplate around HttpRequestMessage and HttpClient.

Getting started

dotnet add package Fluent.Client

https://www.nuget.org/packages/Fluent.Client

using Fluent.Client;

var client = new HttpClient { BaseAddress = new Uri("https://api.example.com/") };

using var response = await client
    .Post("/api/users", new { Name = "John Doe" })
    .SendAsync();

Creating requests

Use the HTTP method extensions on HttpClient to create a FluentHttpRequest:

var request = client.Post("/api/v1/users", new { Name = "John Doe" });
var request = client.Get("/api/v1/users", new { page = 1, limit = 10 });
var request = client.Delete("/api/v1/users/897");
var request = client.Put("/api/v1/users/897", new { Name = "Jane Doe" });

Configuring requests

// Bearer token (default when token is provided)
client.Authorize(token: "jwt-token-here").Get("/api/protected");

// Basic authentication — credentials are Base64-encoded automatically
client.Authorize(username: "john", password: "secret").Get("/api/protected");

// API key — placed in the api-key header by default
client.Authorize(key: "my-api-key").Get("/api/protected");

// Explicit scheme override
client.Authorize(token: "token", kind: AuthorizationType.OAuth).Post("/api/resource");
client.Authorize(token: "token", kind: AuthorizationType.Negotiate).Get("/api/resource");

// Custom header name
client.Authorize(token: "token", header: "X-Auth-Token").Get("/api/protected");

// Query parameters as anonymous object
client.Get("/api/users", new { page = 1, limit = 10, sortBy = "createdAt" });

// Multiple configurations chained
var request = client
    .Authorize(token: "abc123")
    .Get("/api/v1/basket", new { includeItems = true });

Authorization schemes are defined in Fluent.Client.Authenticate.AuthorizationType. The scheme name is used verbatim as the header token — e.g. Bearer, OAuth, HOBA, Negotiate, VAPID.

Windows authentication (NTLM / Kerberos)

NTLM and Kerberos are handled by HttpClientHandler, not by Authorization headers. Configure credentials on the handler before creating the client:

using var handler = new HttpClientHandler
{
    Credentials = new NetworkCredential("user", "password", "domain"),
    // or for the current Windows user:
    // Credentials = CredentialCache.DefaultCredentials,
};
using var client = new HttpClient(handler) { BaseAddress = new Uri("https://internal.corp/") };

using var response = await client.Get("/api/data");

Sending requests

// Get HttpResponseMessage
using HttpResponseMessage response = await request.SendAsync();

if (response.IsSuccessStatusCode)
{
    var content = await response.Content.ReadAsStringAsync();
}

// Deserialize response directly
UserCreatedResponse result = await request.Send<UserCreatedResponse>();

// The request is awaitable — SendAsync is optional
using var response = await client
    .Authorize(token: "abc123")
    .Post("/api/users", new { Name = "John" });

Testing

Pair with Fluent.Client.AwesomeAssertions for integration tests:

await client
    .Authorize(token: "abc123")
    .Post("/api/users", new { Name = "John" })
    .Should()
    .Succeed("because valid user data was provided");

License

Fluent.Client is free and open source software licensed under the MIT License. You can use it in private and commercial projects.
Keep in mind that you must include a copy of the license in your project.