EasyHttpsClient 1.2.0

EasyHttpsClient

v1.2.0

EasyHttpsClient is a simple and easy-to-use HTTP client library for .NET. It provides a fluent API for sending HTTP(s) POST and GET requests and retrieving responses.

Usage

GET Request To send a GET request, use the GETasync method:

var client = new HttpsClient();
client.SetUrl("https://example.com/api/data");
await client.GETasync();
var response = await client.ReadResultAsStringAsync();
Console.WriteLine(response);

To send a POST request, use the POSTasync method:

var client = new HttpsClient();
client.SetUrl("https://example.com/api/PostHereFormUrlEncodedData/");
client.SetBodyPostData(new List<KeyValuePair<string, string>>
{
    new KeyValuePair<string, string>("key1", "value1"),
    new KeyValuePair<string, string>("key2", "value2")
});
await client.POSTasync();
var response = await client.ReadResultAsStringAsync();
Console.WriteLine(response);

To send a POST request with a JSON body, use the SetBodyRequestData method

var client = new HttpsClient();
client.SetUrl("https://example.com/api/PostHereInPostBody/");
//example object, it can be any object that can be serialized
var data = new { key1 = "value1", key2 = "value2", ... }; 

client.SetBodyRequestData(data);
// or use client.SetBodyRequestJson(...);

await client.POSTasync();
var response = await client.ReadResultAsStringAsync();
Console.WriteLine(response);

Setting Timeout and Encoding You can set the timeout and encoding for the HTTP client using the SetTimeout and SetEncoding methods:

var client = new HttpsClient();
client.SetTimeout(10); // set timeout to 10 seconds
client.SetEncoding(Encoding.UTF8); // set encoding to UTF-8

Adding Headers You can add headers to the HTTP request using the AddToRequestHeaders method:

var client = new HttpsClient();
client.AddToRequestHeaders("Authorization", "Bearer token ...");

Supports Fluent syntax

HttpsClient client = new EasyHttpsClient.HttpsClient();

await client
    .SetUrl("https://example.com/etc/GetIt.html")
    .SetTimeout(15)
    .SetEncoding(Encoding.UTF8)
    .GETasync();

byte[] bytearray = await client.ReadResultAsByteArrayAsync();
string response = await client.ReadResultAsStringAsync();

Disposing Don't forget to dispose the HTTP client when you're done with it to free up memory:

var client = new HttpsClient();
// ...
client.Dispose();