Skip to content

JBTech/RestSharp

This branch is 1189 commits behind restsharp/RestSharp:dev.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

658f098 · Apr 30, 2015
Apr 30, 2015
Jan 5, 2015
Mar 24, 2015
Apr 18, 2015
Jan 5, 2015
Mar 24, 2015
Mar 24, 2015
Mar 24, 2015
Mar 24, 2015
Jan 22, 2015
Apr 30, 2015
Nov 7, 2014
Jan 5, 2015
Apr 30, 2015
Apr 30, 2015
Sep 7, 2013
Dec 8, 2014
Oct 26, 2014
Nov 16, 2009
Jan 6, 2015
Dec 19, 2013
Sep 7, 2013
Mar 24, 2015
Dec 19, 2014
Mar 24, 2015
Nov 7, 2014
Mar 24, 2015
Mar 24, 2015
Nov 7, 2014
Mar 24, 2015
Nov 18, 2013
Apr 30, 2015
Aug 27, 2013

Repository files navigation

RestSharp - Simple .NET REST Client Build status

License: Apache License 2.0

Features

  • Supports .NET 3.5+, Silverlight 4, Windows Phone 8, Mono, MonoTouch, Mono for Android
  • Easy installation using NuGet for most .NET flavors
  • Supports strong naming using NuGet for most .NET flavors
  • Automatic XML and JSON deserialization
  • Supports custom serialization and deserialization via ISerializer and IDeserializer
  • Fuzzy element name matching ('product_id' in XML/JSON will match C# property named 'ProductId')
  • Automatic detection of type of content returned
  • GET, POST, PUT, HEAD, OPTIONS, DELETE supported
  • Other non-standard HTTP methods also supported
  • oAuth 1, oAuth 2, Basic, NTLM and Parameter-based Authenticators included
  • Supports custom authentication schemes via IAuthenticator
  • Multi-part form/file uploads
  • T4 Helper to generate C# classes from an XML document
var client = new RestClient("http://example.com");
// client.Authenticator = new HttpBasicAuthenticator(username, password);

var request = new RestRequest("resource/{id}", Method.POST);
request.AddParameter("name", "value"); // adds to POST or URL querystring based on Method
request.AddUrlSegment("id", "123"); // replaces matching token in request.Resource

// add parameters for all properties on an object
request.AddObject(object);

// or just whitelisted properties
request.AddObject(object, "PersonId", "Name", ...);

// easily add HTTP Headers
request.AddHeader("header", "value");

// add files to upload (works with compatible verbs)
request.AddFile("file", path);

// execute the request
IRestResponse response = client.Execute(request);
var content = response.Content; // raw content as string

// or automatically deserialize result
// return content type is sniffed but can be explicitly set via RestClient.AddHandler();
IRestResponse<Person> response2 = client.Execute<Person>(request);
var name = response2.Data.Name;

// or download and save file to disk
client.DownloadData(request).SaveAs(path);

// easy async support
client.ExecuteAsync(request, response => {
    Console.WriteLine(response.Content);
});

// async with deserialization
var asyncHandle = client.ExecuteAsync<Person>(request, response => {
    Console.WriteLine(response.Data.Name);
});

// abort the request on demand
asyncHandle.Abort();

About

Simple REST and HTTP API Client for .NET

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 98.7%
  • Batchfile 1.3%