Sample code for 30+ languages & platforms
Dart

Clickatell Send SMS Text Message

See more Clickatell Examples

Demonstrate how to send a Clickatell SMS text message.

Chilkat Dart Downloads

Dart
import 'package:chilkat/chilkat.dart';

void main() {
  // This example assumes the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  final http = CkHttp();

  // Implements the following CURL command:

  // curl -i \
  // -X POST \
  // -H "Content-Type: application/json" \
  // -H "Accept: application/json" \
  // -H "Authorization: API_KEY" \
  // -d '{"content": "Test Message Text", "to": ["PHONE_NUMBER"], "from": "FROM_PHONE_NUMBER" }' \
  // -s https://platform.clickatell.com/messages

  // Use this online tool to generate code from sample JSON:
  // Generate Code to Create JSON

  // The following JSON is sent in the request body.

  // {
  //   "content": "Test Message Text",
  //   "to": [
  //     "PHONE_NUMBER"
  //   ]
  // }

  final json = CkJsonObject();
  json.updateString('content', 'Test Message Text');
  json.updateString('to[0]', 'PHONE_NUMBER');
  json.updateString('from', 'FROM_PHONE_NUMBER');

  http.setRequestHeader('Authorization', 'API_KEY');
  http.setRequestHeader('Accept', 'application/json');
  http.setRequestHeader('Content-Type', 'application/json');

  // If the following URL does not work, then try "https://platform.clickatell.com/v1/message"
  final resp = CkHttpResponse();
  try {
    http.httpJson('POST', 'https://platform.clickatell.com/messages', json, 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  final sbResponseBody = CkStringBuilder();
  resp.getBodySb(sbResponseBody);
  final jResp = CkJsonObject();
  jResp.loadSb(sbResponseBody);
  jResp.emitCompact = false;

  print('Response Body:');
  print(jResp.emit());

  final respStatusCode = resp.statusCode;
  print('Response Status Code = $respStatusCode');
  if (respStatusCode >= 400) {
    print('Response Header:');
    print(resp.header);
    print('Failed.');
    return;
  }

  // Sample JSON response:
  // (Sample code for parsing the JSON response is shown below)

  // {
  //   "messages": [
  //     {
  //       "apiMessageId": "66c06ac68e5c4afb953ea9328babfde6",
  //       "accepted": true,
  //       "to": "16302581871",
  //       "errorCode": null,
  //       "error": null,
  //       "errorDescription": null
  //     }
  //   ],
  //   "errorCode": null,
  //   "error": null,
  //   "errorDescription": null
  // }

  // Sample code for parsing the JSON response...
  // Use the following online tool to generate parsing code from sample JSON:
  // Generate Parsing Code from JSON

  var errorCode = '';
  var error = '';
  var errorDescription = '';
  var i = 0;
  var apiMessageId = '';
  var vTo = '';

  errorCode = jResp.stringOf('errorCode');
  error = jResp.stringOf('error');
  errorDescription = jResp.stringOf('errorDescription');
  i = 0;
  final countI = jResp.sizeOfArray('messages');
  while (i < countI) {
    jResp.i = i;
    apiMessageId = jResp.stringOf('messages[i].apiMessageId');
    jResp.boolOf('messages[i].accepted');
    vTo = jResp.stringOf('messages[i].to');
    errorCode = jResp.stringOf('messages[i].errorCode');
    error = jResp.stringOf('messages[i].error');
    errorDescription = jResp.stringOf('messages[i].errorDescription');
    i++;
  }
}