RestHttpClient 0.7.0-alpha

.NET Standard 2.0
This is a prerelease version of RestHttpClient.
dotnet add package RestHttpClient --version 0.7.0-alpha
NuGet\Install-Package RestHttpClient -Version 0.7.0-alpha
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RestHttpClient" Version="0.7.0-alpha" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add RestHttpClient --version 0.7.0-alpha
#r "nuget: RestHttpClient, 0.7.0-alpha"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install RestHttpClient as a Cake Addin
#addin nuget:?package=RestHttpClient&version=0.7.0-alpha&prerelease

// Install RestHttpClient as a Cake Tool
#tool nuget:?package=RestHttpClient&version=0.7.0-alpha&prerelease


Simple and flexible REST client built on top of Microsoft's System.Net.HttpClient.


var client = new RestHttpClient
    BaseAddress = new Uri("")

var list = await client.GetAsync<List<Todo>>("todos");

var todo = await client.GetAsync<Todo>("todos/1");

var model = new Todo
    Title = "Lorem Ipsum",
    UserId = 1

var createdTodo = await client.PostAsync<Todo>("todos", model);

Customize serialization

Implement one of ISerializer, IDeserializer, IConverter (combination of both) and set to according property on RestHttpClient:

var client = new RestHttpClient
    BaseAddress = new Uri(""),
    Converter = new JsonRestConverter()


For per-object authentication, just set HttpClient's default headers:

client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic","QWxhZGRpbjpvcGVuIHNlc2FtZQ==");

For per-request authentication, create an instance of RestHttpMessageHandler and set its AuthenticationHandler property as follows: Lambda syntax:

var handler = new RestHttpMessageHandler();
    AuthenticationHandler = async (request) =>
        request.Headers.Add("Authorization", "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==");
        return request;

//Set handler through RestHttpClient's constructor
var client = new RestHttpClient(handler);

Regular method syntax:

//Declare handler method
async Task<HttpRequestMessage> AuthenticateRequestAsync(HttpRequestMessage request)
    request.Headers.Add("Authorization", "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==");
    return request;

//...and then somethere else:
var handler = new RestHttpMessageHandler
    AuthenticationHandler = AuthenticateRequestAsync

//Set handler through RestHttpClient's constructor
var client = new RestHttpClient(handler);

Error handling

Set a method or expression to RestHttpMessageHandler's ErrorHandler property. It will be called in case of error responses:

var handler = new RestHttpMessageHandler();
var client = new RestHttpClient(handler);
handler.ErrorHandler = async (request, response) =>
    //Use request and response object to determine which action to take
    if (request.RequestUri.AbsolutePath.StartsWith("/api") && response.StatusCode == HttpStatusCode.Unauthorized)
        //In this case we set Authentication global header...
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", "QWxhZGRpbjpvcGVuIHNlc2FtZQ==");
        ///... and then return a copy of the request, which will be resent.
        return request.Clone();

    //If you don't wish to resend the request, just return null;
    return null;

Please note that ErrorHandler method won't be called again if the returned request also fails.

If there isn't an error handler set or if the error handler doesn't return a Request object, RestException will be thrown:

    var item = await client.GetAsync<Todo>("todos/800");
//Use RestException's Request, Response or Content properties to determine how to handle the Exception
catch (RestException ex) when (ex.Response?.StatusCode == HttpStatusCode.NotFound)
    Console.WriteLine("Content not found.");
catch (RestException ex)
    Console.WriteLine("Request failed, check out its content: ");

Less common cases

For less common cases, write your request using the HttpRequestMessage class and send it throuth one of the available SendAsync overloads:

var json = "{ title: 'Lorem Ipsum', userId: 1 }";

var request = new HttpRequestMessage
    Method = HttpMethod.Post,
    Content = new StringContent(json, Encoding.UTF8, "application/json"),
    RequestUri = new Uri("todos", UriKind.Relative)

var response = await client.RestSendAsync(request);


Of course you can always use any of HttpClient's methods for any case.


As you may have thought, Authorization and Error handling are actually done by RestHttpMessageHandler and not by RestHttpClient, and hence you can also use its capabilities with the regular HttpClient.

You can also use any other HttpMessageHandler-derived type with RestHttpClient, but please note that Authorization and Error handling capabilities won't be present on RestHttpClient if it doesn't implement IRestMessageHandler.

Version 0.5.0

v0.5.0 had those Rest-prefixes before RestHttpClient's specific calls. Some changes have been made and these prefixes don't exist anymore, so just get rid of them in your calls! 😉

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48 net481
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.7.0-alpha 4,381 4/8/2019
0.6.0-alpha 319 3/28/2019
0.5.0-alpha 381 3/19/2019
0.4.0-alpha 319 3/19/2019
0.3.1-alpha 324 3/19/2019
0.3.0-alpha 323 3/19/2019
0.2.0-alpha 720 3/18/2019
0.1.0-alpha 472 3/18/2019