Introducing RestClient.Net

RestClient.Net is a modern, type-safe REST client for C# that brings functional programming patterns to HTTP communication.

Why Another REST Client?

Traditional HTTP clients in .NET have a problem: they throw exceptions. This forces developers into try/catch blocks and makes error handling inconsistent and error-prone.

RestClient.Net takes a different approach. Instead of throwing exceptions, every HTTP call returns a Result type that must be explicitly handled.

The Power of Discriminated Unions

// Make a GET request
var result = await httpClient.GetAsync(
    url: "https://api.example.com/posts/1".ToAbsoluteUrl(),
    deserializeSuccess: DeserializePost,
    deserializeError: DeserializeError
);

// Pattern match - compiler enforces you handle ALL cases
var output = result switch
{
    OkPost(var post) => $"Success: {post.Title}",
    ErrorPost(ResponseErrorPost(var err, var status, _)) => $"API Error: {status}",
    ErrorPost(ExceptionErrorPost(var ex)) => $"Exception: {ex.Message}",
};

Exhaustiveness Checking

With the Exhaustion analyzer, your code won't compile if you miss a case. No more runtime surprises.

Get Started

dotnet add package RestClient.Net

Check out the documentation to learn more!