Single SMS API Guide :                                                                   Back


Description


This API may be used to create alerts from any external systems using HTTP POST method.When the request comes it will validate

the customer identity and once the identity is validated it will validate input parameters to make sure the required data is available

to process the request. For every mobile no passed to this API will be treated as a contact to the customer and if any mobile no

doesn’t exist in the contact’s list it will create contact automatically. Once the contact lookup/Creation is done then an alert

will be created as per the request.

URL


http://www.Alerts360.com/api/SingleSMS.aspx

API Request


USERNAME- Alerts360 Username (Required)

PASSWORD- Alerts360 Password (Required)

MESSAGE– Message to be sent to the users

TO– Mobile number or comma separated mobile numbers

TIME - Date Time. If time parameter is empty or past time is mentioned then message will go immediately.

API Response

RESPCODE- 0 For Success else Error Code.

RESPMSG- Message.

MSGID- Always 1 for single SMS api.

Response Codes


“0” - Success
“-1” - Unexpected Error
“-100” - Invalid Credentials Passed
“-1000” - Invalid Mobile Number(s) List
“-1001” - Blank Message Passed.

Sample XML Request


<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Single Message API Page</title>
</head>
<body>
<h1> <center>Single Message API</center> </h1>
<form method="post" action= "http://www.alerts360.com/API/SingleSMS.aspx" >
<table>
<tr> <td>User Name </td><td> <input type="text" name="USERNAME"/></td></tr>
<tr><td> Password </td></tr> <input type="PASSWORD" name="password" /></td></tr>
<tr><td>Message</td></tr> <textarea name="MESSAGE" value="" rows="4" cols="100"></textarea> </td></tr>
<tr><td> Mobile Number's(Comma separated)</td><td>> <input type="text" name="TO" value="" size="100" /></td></tr>
<tr><td>Schedule Time (Optional)<br>(dd/mm/yy hh:mm) <br>Ex:20/04/10 13:51</tr></td>
<input type="text" name="TIME" value="" size="20" /></td></tr>
<tr><td></td> <input type="submit" name="Ok" value="Go"> <input type="reset" name="reset" value="Reset"></td></tr>
</table>
</form>
</body>
</html>

Sample XML Response


<? xml version="1.0" encoding="UTF-8"?>
<RESPONSE>
< MSG > ID=”1” RESPCODE=”0” RESPMSG=”Success” SUBMITDATE="20/04/2010 11:31"/>
</RESPONSE>

Back