Tools /
Java SDK for HTTP API

Download at GitHub

Introduction

The BBN SMS Gateway Java SDK for HTTP API (version 1.0) is the first Java port to the BBN SMS Gateway HTTP API provided by a Contributor, Victor Igbokwe. Java developers can now interface with the BBN SMS Gateway API with ease - not having to write long lines of code to do same from project to project. Java developers can easily adopt the library into any project that needs to send sms using the BBN SMS Gateway.

Getting Started

To get started with the BBN SMS Gateway Java SDK for HTTP API Integration:

Download the Java SDK from GitHub
Extract the file to a suitable location on your computer
Follow the Configuration and Example Usage instruction

Configuration

There's little need for configuration. Most of the common configuration is already provided in bbn/api/sms/bbn.properties; however, there's a small matter of authentication username and password. This can be provided in your own .properties file:

For example, create the file "bbn.properties" in the root of your application's classpath (note: it must be called bbn.properties) add these lines to the file.

username=<your username>
password=<your password>
e.g. [email protected]
password=password123

Then your code can go like this:

import bbn.api.sms.BbnApi;
...
BbnApi api = new BbnApi();
api.checkBalance();

This will check the credit balance for the user whose user details you provided in your config file (bbn.properties). Another option is to provide the authentication username and password manually for every operation. e.g:

import bbn.api.sms.BbnApi;
...
BbnApi api = new BbnApi();
api.checkBalance("[email protected]", "password123");

Sample Usage

The source code for how to use the API is available as tests in the tests package; however, here's a quick look at how to use the API.

Sending Sample Text

import bbn.api.sms.BbnApi;
...
SMS sms = new SMS();
sms.setMessage("This is a test message.");
sms.setSender("senderid"); // The sender id can be a mobile number.
sms.setMobile("+2347031234567"); // Check the BBN website for details on the country codes supported and the preferred format.
BbnApi api = BbnApi.getInstance();
Result result = api.sendMessage(sms); // Send the message to the recipient specified as mobile.

// Make sure there was no error message.
if (!result.isError()) {
// Show message indicating the message was sent successfully.
}

For integration support, send an email to Victor Igbokwe: [email protected]

PHP SDK for HTTP API
Java SDK for HTTP API
BBN WebConnect Plugin

Technical Support

For integration issues, send the details including how to replicate the fault in an email to lab@bbnplace.com