Java
Overview
Used for server applications and mobile development. After signing up, use this Java library to build into your system. You can use this Java library with our HTTP or REST messaging APIs to interact with the Clickatell SMS Gateway. The Java library below allows you to send one- or two-way SMS messages using Clickatell’s SMS Platform.
You can see our other libraries and more documentation at the Clickatell APIs and Libraries Project.
Usage
Copy the class files directly into your project and reference the JSON-simple-1.1.1.jar library. Then use as described below.
To initialize:
ClickatellHttp click = new ClickatellHttp(USERNAME, APIID, PASSWORD); ClickatellRest clickRest = new ClickatellRest(API_KEY); |
To send one message:
ClickatellHttp.Message response = click.sendMessage( "27821234567" , "Hello, this is a test message!" ); ClickatellRest.Message response = clickRest.sendMessage( "27821234567" , "Hello, this is a test message!" ); |
To get the status of a message:
int status = click.getMessageStatus( "b305c3445e37626ffabb21edc9320e1e" ); |
To get the cost of a message:
ClickatellHttp.Message reply = click.getMessageCharge( "b305c3445e37626ffabb21edc9320e1e" ); System.out.println( "Charge: " + reply.charge); System.out.println( "Status: " + reply.status); |
To get the cost and status of the message in REST:
ClickatellRest.Message msg = clickRest.getMessageStatus(response.message_id); System.out.println( "ID:" + msg.message_id); System.out.println( "Status:" + msg.status); System.out.println( "Status Description:" + msg.statusString); System.out.println( "Charge:" + msg.charge); |
To do a coverage check:
double reply = click.getCoverage( "27820909090" ); |
To do a message stop request:
click.stopMessage( "b305c3445e37626ffabb21edc9320e1e" ); |
To check your balance:
double balance = click.getBalance(); |
Testing sample code
Compile:
javac -cp json-simple- 1.1 . 1 .jar ClickatellRest.java ClickatellHttp.java Runner.java |
Run:
java -cp .:json-simple- 1.1 . 1 .jar Runner |
Clickatell Java library – platform branch
This SDK is based on the new Clickatell platform. Instead of checking out this codebase, you can download the Clickatell-java-sdk.jar file from https://github.com/clickatell/clickatell-java/tree/platform/bin/artifacts/clickatell_java_sdk_jar.
Testing
Testing can be done by editing the classes TestClickatellHttp and TestClickatellRest. You will need to supply your apiKey along with the number you would like to send the message to.
Submit a Comment
Other Resources
Ask the Community
Visit Stack Overflow to join our community of developers and find the answer you need
Contact Support
Contact our support team and one of our agents will be in touch with you to answer any questions you have