Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,602 Commits
.github/workflows		.github/workflows
src		src
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
FUNDING.yml		FUNDING.yml
LICENSE		LICENSE
README.md		README.md

Repository files navigation

.NET REST Client Framework for all platforms

RestClient.Net is a powerful .NET REST API client that features task-based async, strong types, and dependency injection support for all platforms. Use it to consume ASP.NET Core Web APIs or interact with RESTful APIs over the internet in C#, F#, or Visual Basic. It's designed with functional-style programming and F# in mind.

NuGet:RestClient.Net

Follow Me on Twitter for Updates

6.0 Release

This release updates all dependencies and targets major versions of .NET: 4.5, 5, 6, and 7.

Follow Me on Twitter for Updates

Key Features

First-class URLs: UtilizesUrls to treat URLs as immutablerecords with a fluent API for construction.
Dependency Injection Support: Easily mock REST calls and add RestClient.Net to your IoC container with a single line of code.
Async-Friendly: All operations use async and await keywords.
Automatic Serialization: Automatically serializes request/response bodies to/from strong types (JSON, Binary, SOAP,Google Protocol Buffers). The library is decoupled from Newtonsoft, allowing you to use any serialization method or version of Newtonsoft. This means compatibility with any version of Azure Functions.
Cross-Platform Compatibility: Install from NuGet on any platform from .NET Framework 4.5 up to .NET 5. Supports Xamarin (Mono, iOS, Android), UWP,WebAssembly, and Unity with .NET Standard 2.0.
HTTP Methods: Supports GET, POST, PUT, PATCH, DELETE, and custom methods.
Fluent API: Provides a fluent API for construction, non-destructive mutation, and URL construction.
Logging: Uses .NET Core Logging -ILogger for logging all aspects of HTTP calls.
Thread Safety: Immutable client for thread safety.
High-Quality Code: Tight code and complete test coverage allow you to make changes if needed.

Examples

For a complete set of examples, see theseunit tests.

POST an Object and get Response

usingvarclient=//Build the Url from the host namenewClient("jsonplaceholder.typicode.com".ToHttpsUriFromHost());UserPostuserPost=awaitclient.PostAsync<UserPost,UserPost>(//POST the UserPost to the servernewUserPost{title="Title"},"posts");

Dependency Injection (RestClient.Net.DependencyInjection NuGet Package)

Wiring it up

varserviceCollection=newServiceCollection()//Add a service which has an IClient dependency.AddSingleton<IGetString,GetString1>()//Add RestClient.Net with a default Base Url of http://www.test.com.AddRestClient((o)=>o.BaseUrl="http://www.test.com".ToAbsoluteUrl());//Use HttpClient dependency injection_=serviceCollection.AddHttpClient();

Getting a Global IClient in a Service

publicclassGetString1:IGetString{publicIClientClient{get;}publicGetString1(IClientclient)=>Client=client;publicasyncTask<string>GetStringAsync()=>awaitClient.GetAsync<string>();}

Getting a IClient Using a Factory

publicclassGetString2:IGetString{publicIClientClient{get;}publicGetString2(CreateClientcreateClient){//Use the options to set the BaseUrl or other properties on the ClientClient=createClient("test",(o)=>{o.BaseUrl=o.BaseUrlwith{Host="www.test.com"};});}publicasyncTask<string>GetStringAsync()=>awaitClient.GetAsync<string>();}

Make Call and Construct Client

//This constructs an AbsoluteUrl from the string, makes the GET call, and deserializes the JSON to a strongly typed list//The response also contains a Client with the base of the Url that you can reuse//Note: not available on .NET 4.5varresponse=await"https://restcountries.eu/rest/v2".ToAbsoluteUrl().GetAsync<List<RestCountry>>();

Query Github Issues with GraphQL (You must authorize GraphQL Github App)

usingRestClient.Net.Abstractions.Extensions;usingSystem.Collections.Generic;usingSystem.Threading.Tasks;usingUrls;namespaceRestClient.Net{publicstaticclassGitHubGraphQLMethods{publicstaticasyncTask<T>GetIssues<T>(stringrepo,stringaccessToken)=>(await"https://api.github.com/graphql".ToAbsoluteUrl().PostAsync<QueryResponse<T>,QueryRequest>(newQueryRequest("{ search(query:\"repo:"+repo+"\", type: ISSUE, first: 100) {nodes {... on Issue { number title body } } }}"),HeadersExtensions.FromBearerToken(accessToken).Append("User-Agent","RestClient.Net"))).Response.Body.data.search;}publicrecordQueryRequest(stringquery);publicrecordIssue(int?number,stringtitle,stringbody);publicrecordIssues(List<Issue>nodes);publicrecordData<T>(Tsearch);publicrecordQueryResponse<T>(Data<T>data);}

Url Construction with F#

[<TestMethod>]memberthis.TestComposition()=leturi="host.com".ToHttpUrlFromHost(5000)        .AddQueryParameter("fieldname1","field<>Value1")        .WithCredentials("username","password")        .AddQueryParameter("FieldName2","field<>Value2")        .WithFragment("frag")        .WithPath("pathpart1","pathpart2")    Assert.AreEqual("http://username:password@host.com:5000/pathpart1/pathpart2?fieldname1=field%3C%3EValue1&FieldName2=field%3C%3EValue2#frag",uri.ToString());