Android™ Requires Chilkat v11.0.0+
Android™
Clickatell HTTP API: Send an SMS with query parameters
See more Clickatell Examples
Use an SMS integration configured for HTTP in the Clickatell Portal. The endpoint takes apiKey, to, and content as query parameters. Pass raw values to Chilkat so it can encode spaces, ampersands, and other reserved characters. Supply a country code and phone number as digits. Set from when your two-way integration requires a sender.
The URL contains the API key, recipient, and message text. Keep full request URLs out of logs and browser history. Check the per-message result after HTTP 202. If the connection is interrupted, check the Portal message report before resending. For the header-authenticated JSON workflow, see Send an SMS with One API.
Chilkat Android™ Downloads
// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;
import android.app.Activity;
import com.chilkatsoft.*;
import android.widget.TextView;
import android.os.Bundle;
public class SimpleActivity extends Activity {
private static final String TAG = "Chilkat";
// Called when the activity is first created.
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
boolean success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
CkHttp http = new CkHttp();
http.put_RequireSslCertVerify(true);
// Use the key issued for this HTTP integration. Chilkat encodes each query value.
CkHttpRequest query = new CkHttpRequest();
query.put_HttpVerb("GET");
query.AddHeader("Accept","application/json");
query.AddParam("apiKey","HTTP_API_KEY");
query.AddParam("to","PHONE_NUMBER");
query.AddParam("content","Test message: pickup between 2 & 4.");
String sender = "";
if (sender != "") {
query.AddParam("from",sender);
}
CkHttpResponse resp = new CkHttpResponse();
success = http.HttpReq("https://platform.clickatell.com/messages/http/send",query,resp);
if (resp.get_StatusCode() == 0) {
Log.i(TAG, "The send outcome is unknown. Check the message report before resending.");
return;
}
CkJsonObject reply = new CkJsonObject();
boolean parsed = reply.Load(resp.bodyStr());
if ((success != true) or ((resp.get_StatusCode() != 202))) {
Log.i(TAG, "Clickatell returned HTTP " + String.valueOf(resp.get_StatusCode()));
if (parsed == true) {
if (reply.HasMember("errorDescription") == true) {
Log.i(TAG, reply.stringOf("errorDescription"));
}
}
return;
}
if (parsed != true) {
Log.i(TAG, "Expected a JSON response.");
return;
}
// A request-level error applies to the submission as a whole.
if (reply.HasMember("errorCode") == true) {
if (reply.IsNullOf("errorCode") != true) {
Log.i(TAG, "Submission error " + reply.stringOf("errorCode") + " " + reply.stringOf("errorDescription"));
return;
}
}
int count = reply.SizeOfArray("messages");
if (count <= 0) {
Log.i(TAG, "No recipient results returned. Check the message report before resending.");
return;
}
int i = 0;
while ((i < count)) {
reply.put_I(i);
int resultNumber = i + 1;
// JsonTypeOf returns 5 for a JSON boolean.
if (reply.JsonTypeOf("messages[i].accepted") != 5) {
Log.i(TAG, "Result " + String.valueOf(resultNumber) + " has no acceptance flag.");
}
else {
if (reply.BoolOf("messages[i].accepted") == true) {
String messageId = reply.stringOf("messages[i].apiMessageId");
if ((reply.JsonTypeOf("messages[i].apiMessageId") != 1) or (messageId == "")) {
Log.i(TAG, "Result " + String.valueOf(resultNumber) + " was accepted without a tracking ID.");
}
else {
Log.i(TAG, "Result " + String.valueOf(resultNumber) + " accepted. Message ID: " + messageId);
}
}
else {
Log.i(TAG, "Result " + String.valueOf(resultNumber) + " rejected: " + reply.stringOf("messages[i].errorCode") + " " + reply.stringOf("messages[i].errorDescription"));
}
}
i = i + 1;
}
}
static {
System.loadLibrary("chilkat");
// Note: If the incorrect library name is passed to System.loadLibrary,
// then you will see the following error message at application startup:
//"The application <your-application-name> has stopped unexpectedly. Please try again."
}
}