Hubtel HTTP API .NET SDK

Overview

This is an open source .NET SDK that allows you to access the Hubtel REST SMS API from your C# application. You need to create a Hubtel account in order to use this API.

Notice

• This is the source code for the current release.
• The source code of the previous release can be found here.

Installation

The SDK can smoothly run on any .Net Platform if it is compiled in the right environment. There are two ways of using the SDK

• Clone the repo and run it in Visual Studio
• Download the binaries from the binaries folder. The folder is organized around the various .Net Platform supported. Each folder contains the required dlls to use. Download the appropriate folder and add it to your project library path or reference path.

Usage

The SDK currently is organized around four main classes:

• MessagingApi.cs : It handles sending and receiving messages, NumberPlans, Campaigns, Keywords, Sender IDs and Message Templates management.(For more information about these terms refer to Our developer site.)
• ContactApi.cs : It handles all contacts related tasks.
• AccountApi.cs : It handles the API Account Holder data.
• SupportApi.cs : It helps any developer to interact with our support platform via his application.
• ContentApi.cs : It handles all content related tasks.

Examples

• How to Send a Message

    public class Demo
    {
        public static void Main(string[] args)
        {
            const string clientId = "user233";
            const string clientSecret = "password23";
            try {
                var host = new ApiHost(new BasicAuth(clientId, clientSecret),"https://sms-api.hubtel-test.com/v1/messages/send");
                var messageApi = new MessagingApi(host);
                MessageResponse msg = messageApi.SendQuickMessage("Wazza", "+233244675897", "Hello Big Bro!", true);
                Console.WriteLine(msg.Status);
            }
            catch (Exception e) {
                if (e.GetType() == typeof (HttpRequestException)) {
                    var ex = e as HttpRequestException;
                    if (ex != null && ex.HttpResponse != null) {
                        Console.WriteLine("Error Status Code " + ex.HttpResponse.Status);
                    }
                }
                throw;
            }
            Console.ReadKey();
        }
    }

• How to Schedule a Message

    public class Demo
    {
        public static void Main(string[] args)
        {
            const string clientId = "user233";
            const string clientSecret = "password23";
            try {
                var host = new ApiHost(new BasicAuth(clientId, clientSecret),"https://sms-api.hubtel-test.com/v1/messages/send");
                var messageApi = new MessagingApi(host);
                // scheduling message from 4 days from now.
                Message message = new Message {
                    From = "wazza",
                    To = "+233246876456",
                    Content = "I am scheduling this message",
                    Time = DateTime.UtcNow.AddDays(4)
                };
                messageApi.SendMessage(message);
                Console.WriteLine(msg.Status);
            }
            catch (Exception e) {
                if (e.GetType() == typeof (HttpRequestException)) {
                    var ex = e as HttpRequestException;
                    if (ex != null && ex.HttpResponse != null) {
                        Console.WriteLine("Error Status Code " + ex.HttpResponse.Status);
                    }
                }
                throw;
            }
            Console.ReadKey();
        }
    }

Please do explore the MessagingApi class for more functionalities.

• How to view Account Details

    public class Demo
    {
        public static void Main(string[] args)
        {
            const string clientId = "user233";
            const string clientSecret = "password23";
            try {
                var host = new ApiHost(new BasicAuth(clientId, clientSecret),"https://sms-api.hubtel-test.com/v1/messages/send");
                var accountApi = new AccountApi(host);
                AccountProfile profile = accountApi.GetAccountProfile();
                Console.WriteLine("Profile Account Id {0}", profile.AccountId);
            }
            catch (Exception e) {
                if (e.GetType() == typeof (HttpRequestException)) {
                    var ex = e as HttpRequestException;
                    if (ex != null && ex.HttpResponse != null) {
                        Console.WriteLine("Error Status Code " + ex.HttpResponse.Status);
                    }
                }
                throw;
            }
            Console.ReadKey();
        }
    }

Please do explore the AccountApi class for more functionalities.

• Notes The ContactApi, SupportApi and ContentApi classes follow almost the same pattern of functionalities, please do explore them to grab their capabilities. The methods in those classes are self explanatory.