REST.NET is a simple REST and HTTP API Client for .NET Core. Why another REST client? When I started developing .NET core I couldn't find a suitable replacement for RestSharp library that suits my needs, so I decided to create one. It's basically a wrapper around HttpClient, which makes API calls much simpler and with fewer lines of code.

Note: I'm developing this library per my project needs on my free time. So not everything you expect might be here and I didn't have a chance to check everything up. You are welcome to help (even reporting known bugs or suggesting features by opening an issue is helpful).

Pro tip: Much can be learned from having a look at the Unit Tests project ;)

REST.NET is available via NuGet package:

Install-Package Rest.Net

Creating RestClient

The first thing you will need to do is create a RestClient. This object is what's wrapping HttpClient and responsible for dispatching http requests. You can use the same object for multiple calls.

IRestClient client = new RestClient("http://www.yourapi.com/");

Making API requests

Most of the libraries I encountered (including the HttpClient object) requires you to first create a request object and pass that to the client - which for most use cases I found redundant and unnecessary. 90% of the time I found myself writing the same request object, so to simplify, REST.NET supports sending "simple" requests directly from the client object.

Synchronous requests examples

// GET requests
IRestResponse<string> result = client.Get("/person/123");
IRestResponse<Person> person = client.Get<Person>("/person/123");

// PUT requests
Person person = new Person()
{
    FirstName = "Ophir",
    LastName = "Oren"
};
IRestResponse<string> result = client.Put("/person", person);
IRestResponse<Person> person = client.Put<Person>("/person");

// POST requests
Person person = new Person()
{
    Id = 1,
    FirstName = "Ophir",
    LastName = "Oren"
};
IRestResponse<string> result = client.Post("/person", person);
IRestResponse<Person> person = client.Post<Person>("/person");

// POST requests
Person person = new Person()
{
    Id = 1
};
IRestResponse<string> result = client.Delete("/person", person);
IRestResponse<Person> person = client.Delete<Person>("/person");

More docs coming soon....