Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


It is always possible for your request to return an error. If an error occurs, e.g. if your API username/password is incorrect, our wrapper will throw a Java exception. If you're not familiar with handling exceptions in Java, it basically means you need to put the wrapper function calls in a try-catch block as shown in the code example from here.

Code Block
try {
	Hashtable<String, String> result;
	result = tmClient.sendSMS("My message", "447000000000", "Sender", 72, "", "", null);
} catch(RestClientException e) {
	Hashtable<String, String> errors = tmClient.getLastErrors();

You must decide how to handle errors according to the logic of your particular application.
For example, if you're building a web interface to send text messages, and a send fails, you may wish to show a visual alert to the user.
Note that more than one error can be reported at once. Therefore although a single Java exception (the first of the errors) is thrown, the complete set of errors encountered is available in an Hashtable of key-value pairs. The key of each pair is the error code and the value is a detailed description of the error. This is why the example displays the errors using the following code:

Code Block
for(Map.Entry<String, String> error: errors.entrySet())
	System.out.println("Error code " + error.getKey() + ": " + error.getValue());
titleYou must know!

Our example code is an illustration of how you might integrate with our systems and is not certified for production environments. You are responsible for testing and QA.