Credit Balance Request Command
May 19th, 2009
A request sent to the SMS API with correct Authentication details can now request its current balance, using the new Action property.
A sample request is displayed below:
http://sms.hostingireland.ie/?username=USERNAME&password=PASSWORD&action=creditrequest
The usual error messages, documented here apply, as well as a new XML response code, the response code is 101, which implies a succesful credit query, and will also have a log entry ID. an example reply is found below:
<smsapi> <result code="101" id="cdaef13616e100fcd9fb80ef15a886ff">561</result> </smsapi>
This response code can now be used to check for sufficient credits before attempting to send a bulk of SMS messages, this will help prevent issues with your local sending code, and also reduce the load on the SMS API server.
As usual, you can send any feedback on this to smsapi@hostingireland.ie or send a post in our forum.