Awesome
Quickly and easily access any RESTful or RESTful-like API.
If you are looking for the Twilio SendGrid API client library, please see this repo.
Table of Contents
- Announcements
- Installation
- Quick Start
- Library Usage Documentation
- Use Cases
- How to Contribute
- Thanks
- About
- Support
- License
<a name="announcements"></a>
Announcements
All updates to this project are documented in our CHANGELOG.
<a name="installation"></a>
Installation
Prerequisites
- .NET Framework 4.5+
Install Package
To use CSharp.HTTP.Client in your C# project, you can either <a href="https://github.com/sendgrid/csharp-http-client.git">download the Twilio SendGrid C# .NET libraries directly from our Github repository</a> or, if you have the NuGet package manager installed, you can grab them automatically.
PM> Install-Package SendGrid.CSharp.Http.Client
Once you have the library properly referenced in your project, you can include calls to them in your code. For a sample implementation, check the Example folder.
Add the following namespace to use the library:
using SendGrid.CSharp.HTTP.Client;
<a name="quick-start"></a>
Quick Start
Here is a quick example:
GET /your/api/{param}/call
using SendGrid.CSharp.HTTP.Client;
globalRequestHeaders.Add("Authorization", "Bearer XXXXXXX");
dynamic client = new Client(host: baseUrl, requestHeaders: globalRequestHeaders);
var response = await client.your.api._(param).call.get()
Console.WriteLine(response.StatusCode);
Console.WriteLine(response.Body.ReadAsStringAsync().Result);
Console.WriteLine(response.Headers.ToString());
POST /your/api/{param}/call
with headers, query parameters and a request body with versioning.
using SendGrid.CSharp.HTTP.Client;
using Newtonsoft.Json;
globalRequestHeaders.Add("Authorization", "Bearer XXXXXXX");
dynamic client = new Client(host: baseUrl, requestHeaders: globalRequestHeaders);
string queryParams = @"{'Hello': 0, 'World': 1}";
requestHeaders.Add("X-Test", "test");
string requestBody = @"{'some': 1, 'awesome': 2, 'data': 3}";
Object json = JsonConvert.DeserializeObject<Object>(requestBody);
var response = await client.your.api._(param).call.post(requestBody: json.ToString(),
queryParams: queryParams,
requestHeaders: requestHeaders)
Console.WriteLine(response.StatusCode);
Console.WriteLine(response.Body.ReadAsStringAsync().Result);
Console.WriteLine(response.Headers.ToString());
<a name="use-cases"></a>
Use Cases
You can find a selection of use cases for this library in our Use Cases directory.
<a name="contribute"></a>
How to Contribute
We encourage contribution to our projects, please see our CONTRIBUTING guide for details.
Quick links:
<a name="thanks"></a>
Thanks
We were inspired by the work done on birdy and universalclient.
<a name="about"></a>
About
csharp-http-client is maintained and funded by Twilio SendGrid, Inc. The names and logos for csharp-http-client are trademarks of Twilio SendGrid, Inc.
<a name="support"></a>
If you need help using SendGrid, please check the Twilio SendGrid Support Help Center.