RestHttpClient 0.2.0-alpha

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

Usage

var client = new RestHttpClient
{
    BaseAddress = new Uri("https://jsonplaceholder.typicode.com")
};

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

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

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

var createdTodo = await client.RestPostAsync<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("https://jsonplaceholder.typicode.com"),
    Converter = new JsonRestConverter()
};

Authorization

Implement IAuthenticator and set it to RestHttpClient.

var client = new RestHttpClient
{
    BaseAddress = new Uri("https://jsonplaceholder.typicode.com"),
    Authenticator = new BasicAuthenticator()
};

You can also override OnAuthorizationError or add an event handler to AuthorizationFailed event. Requests failed with Unauthorized(401) status are retried once. Before the retry happens, OnAuthorizationError, AuthorizationFailed and Authenticator.OnAuthorizationError methods are invoked, in that order, and hence you can use these methods to update RestHttpClient or HttpRequestMessage to ensure that the next request will succeed. Example:

client.AuthorizationFailed += (o, e) =>
{
    //Per request
    e.Request.Headers.Add("Authorization", "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==");
    //Per instance
    client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", "QWxhZGRpbjpvcGVuIHNlc2FtZQ==");
};

Less common cases

For less common cases, write your request using the HttpRequestMessage class and send it throuth one of the available RestSendAsync 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, authRetry: false);

Assert.True(response.IsSuccessStatusCode);