Promotional API

Pushing SMS messages

For sending messages use the URL given below:
http://203.129.203.254/sms/user/urlsms.php?username=demo123&pass=demo12345&senderid=
060000&message=Testt&dest_mobileno=919999999999,919999999998&response=Y
The parameters that are going to be passed and their description is given in the table given below:

	Parameter name		Parameter Description
Username		This contains the username of the user
Pass		This contains the password of the user
Senderid		This field holds the header that will be displayed on the mobile phone
Message		This is message which will not contain more than160 characters.
dest_mobileno		This field has all the Mobile numbers that are separated by a comma. The maximum number that can be send in a signal request is 300. Please don’t send more that 300 numbers.
Response		The default parameter is Y. This filed returns the schedule id with date of SMS submission

Here is the list of return values when the HTTP request is made

	Parameter name		Parameter Description
Message is blank		This will return when there is no message in the URL
Invalid Username and Password		This will return when authentication is failed.
Account is Expire		This will return when the account is expired.
You have Exceeded your SMS Limit.		This will return when your uploaded messages are more then your balance left
Invalid Sender ID		This will return when the Sender ID is invalid
If response is “Y” 5068570-2008_12_29 5068571-2008_12_29		This will return when messages are successfully uploaded with schedule id and followed by today’s date.

Pushing Long SMS messages

For sending long messages use the URL given below:
http://203.129.203.254/sms/user/urllongsms.php?username=demo123&pass=demo12345&sende
rid=060000&message=Testt&dest_mobileno=919999999999,919999999998&response=Y
The parameters that are going to be passed and their description is given in the table given below:

Parameter name	Parameter Description
username	This contains the username of the user
Pass	This contains the password of the user
senderid	This field holds the header that will be displayed on the mobile phone
message	This is message which will not contain more than 800 characters.
dest_mobileno	This field has all the Mobile numbers that are separated by a comma. The maximum number that can be send in a signal request is 300. Please don’t send more that 300 numbers.
response	The default parameter is Y. This filed returns the schedule id with date of SMS submission

Here is the list of return values when the HTTP request is made

Parameter name	Parameter Description
Message is blank	This will return when there is no message in the URL
Invalid Username and Password	This will return when authentication is failed.
Account is Expire	This will return when the account is expired.
You have Exceeded your SMS Limit.	This will return when your uploaded messages are more than your balance left
Invalid Sender ID	This will return when the Sender ID is invalid
If response is “Y” 5068570-2008_12_29 5068571-2008_12_29	This will return when messages are successfully uploaded with schedule id and followed by today’s date.

Checking Credits

For checking credits use the URL given below:
http://203.129.203.254/sms/user/balance_check.php?username=ur demo&pass=demo12345
The parameters that are going to be passed and their description is given in the table given below:

Parameter name	Parameter Description
username	This will contain the username of the user
Pass	This will contain the password of the user

Here is the list of return values when the HTTP request is made

Parameter name	Parameter Description
Your Balance is : 2313	It will show the balances left in your account
Invalid Username and Password. Please try again	This will return when authentication is failed.

Changing Password

For changing the password the URL is given below:
http://203.129.203.254/sms/user/change_password.php?username=&oldpassword=
demo &newpassword=abcd12345

Parameter name	Parameter Description
username	This will contain the username of the user
old password	This will contain the password of the user
new password	This will contain the new password that has to be changed with old password.

Here is the list of return values when HTTP request is made

Parameter Name	Parameter Description
Your Balance is : 2313	It will show the balance left in your account
Invalid Username and Password. Please try again	This will be returned when authentication is failed.

Delivery reports

For checking delivery reports use the URL given below:
http://203.129.203.254/sms/user/responce.php?Scheduleid= 42743328-2009_11_19,42774298- 2009_11_19
FTP:
The client FTP details has to share with us where we can upload the DRL's in an interval of 15 mins This URL is used for collecting the delivery status of the submitted SMS. The parameters that are going to be passed and their description is given in the table given below:

Parameter name	Parameter Description
Scheduled id	This contains the scheduled id along with the date of SMS submission separated by comma. The maximum scheduled id should not be more than 100.

Here is the list of return values when the HTTP request is made

Parameter name	Parameter Description
DELIVRD	This returns when SMS is delivered.
UNDELIV	This returns when SMS is undelivered.
EXPIRED	This returns when SMS is expired.
FAILED	This returns when SMS is failed.

For HTTPS all the links would remain the same with HTTP converted to HTTPS links.