HTTP SMS Gateway
HTTP is the protocol of the web and is extremely easily to implement. Using our HTTP SMS Gateway, you can even send messages straight from your web-browser. Implementing simple HTTP requests in PHP is extremely simple, and it is pretty simple to implement in many other languages and environments.
This page gives a brief overview of the HTTP interface of our gateway and shows some sample requests. Whether you use HTTP POST or GET the input parameters and output are the same.
|
|
|
|
Request Parameters |
|
|
|
|
|
Input Parameters |
|
|
to |
Either a single number, or a comma seperated list of numbers to send to. |
|
|
from |
The number or short name you are sending the message from. If omitted or left blank, the default 'SMS From' for you account will be used instead. |
|
|
message |
The text of the message, maximum 160 characters. Remember this must be URL encoded. |
|
|
username |
Your SMS account username |
|
|
password |
Your SMS account password |
|
|
|
|
|
Output |
Returned in the response separated by hyphens ('-'). |
|
|
resultCode |
The result of the procedure call, zero if OK, otherwise an error code. |
|
|
transactionID |
The transaction ID if it was successful. |
|
|
balance |
The number of message credits available in the account. |
|
|
creditLimit |
The size of your credit limit |
|
|
|
|
|
|
|
HTTP GET Method
With HTTP GET, the parameters are put in the URL of the request. This means you can use web browser to send simple messages without any programming whatsoever. The only limitation with this method is the number of characters you can have in the request line (normally 1024 is the maximum). So it is better to use this method with small amounts of numbers of phone numbers in the "to" parameter. If you need to send to lots of people, use the POST method.
An example of a GET request to send an SMS to Andrew in Standingwave Sales would be:
http://sms.standingwave.co.uk/sendMessage?to=447774726989
&from=your_number&message=messageText&username=user
&password=pass
HTTP POST Method
With HTTP POST, the form parameters are put in the body of the request. This allows the request to be much longer, so this method is useful if you have a very large list of numbers to send messages to.
For 4D Developers
4D developers can easily utilise this method of sending SMS messages by writing a HTTP Client using 4D Internet Commands or Internet Toolkit. Alternatively you could use QFree from Escape Information Services which has a built-in HTTP client or HTTP Client Deux from Deep Sky Technology.
|
