Gateway API
Service
Applications
SMS Inbound

Click here for online chat support

SMS Gateway API                                                
 

” We   looked  at  a  number of  API  suppliers,  but  1609SMS  was  the 1st  to  meet  all  our requirements: 1)  the API  features gave  me the  functionality  that I needed 2) it was easy to integrate 3) cost effective and 4) the services was reliable– a 100% uptime guarantee and the quality of their large clients was reassuring, especially  in a  market with a lot of ‘fly-by-night’ providers. Their technical support has also been very good. - Josh Bauer,  Aganor B.V.

 

General data :

With a 1609SMS IP-SMS account, you get the powerful middleware available through the advanced 1609SMS Message Gateway, to connect directly to the power stations of premium European Mobile operators. This allows you to create sms messages from any existing application (with Internet connection) or website,  simply by posting a http request to the 1609sms server or otherwise by using the more details by hovering over text module to send individual or group messages using our client platform. The request is verified and you receive a response from the 1609SMS server. Creating and unlocking SMS messages from your existing applications has never been so easy and fast. Through our gateways you can very easily integrate your existing management software with our services and for example encode your password, with opens in new page SHA-1 encoding for extra security. Of course you can also link a more details by hovering over text virtual number to our systems, opens in new page receive incoming text messages, and create automatic respons actions.

Summary:

  • SMS messages that can be generated over the http-protocol

  • Enrich and unlock (Web) applications with SMS

  • Suitable for all programming languages and scripts   opens in new page  PHP example

Some applications for IP-SMS

  • Planning or inventory systems linked to SMS. Inform your customers real-time with SMS on the status of orders.

  • SMS service to make your site more interactive: Think about driving directions, contact information and the latest news by SMS.

  • Streamline internal business processes, Confirm appointments for your sales team, make important announcements, and receive notifications when servers are down etc...

  • Clientele that use the 1609SMS Gateway API are for example :

TNT uses the 1609SMS Gateway & API TomTom uses the de 1609SMS Gateway & API Traxdata uses the 1609SMS Gateway & API Wesc uses the 1609SMS Gateway & API Nokia uses the 1609SMS Gateway & API Atomic uses the 1609SMS Gateway & API Australian Gold uses thee 1609SMS Gateway & API  

Technical data :

Address the URL :

The 1609SMS message gateway is connected with many European SMSC-Gateway stations, so a good Quality of Service (availability, capacity and speed) is available. The most common method of passing messages through our gateway, wether to send or receive, is through the HTTP GET / POST protocol.

Through an HTTP request (GET or POST) , our gateway can be connected to your private software application.

http://217.19.227.48/module/gateway.php?clientuser=USERNAME&clientpwd=PASSWORD&message=MESSAGE&to=TO&sender=SENDER

give it a try in your browser (simple test) - When you copy the above string to a browser, enter your Username and Password, you can easily send bulk/group sms messages over URL. When you ad 44762345678,4476612345677, only seperated by a comma, you're sending to multiple mobile numbers. Open your opens in new page  test account to give this a try.

Answer

Explanation

Comment

OK

Your text message was sent successfully

Your text message was sent successfully

ERROR x.x.x

There was a problem + errorcode

A list of possible errorcodes can be found below


For more information on hoover for more details sending or more information on receiving sms messages receiving text messages ?

Note :

You must always encode the above url before you send, as it should not contain spaces
Example : message=this is a test , this should be : message=this%20is%20a%20test
When using PHP, there is a simple function for this :
opens in new page urlencode($url);
This must be done for the sendername as well, in case
you want to use spaces or other special characters !

UTF-8 (8-opens in new page bit Unicode Transformation Format) is one way to opent in nieuwe pagina Unicode/ISO 10646-save characters as a stream of opens in new page bytes, a so called opens in new page character encoding. UTF-8 is a character encoding with a variable length: not every character uses the same amount of bytes. Depending on the character, between 1 and 4 bytes are being used. Because many Western characters only take 1 byte, UTF-8 is more compact for western languages. When you send via our gateway(s), make sure that your message (message) and the sender name (sender) is UTF-8 encoded. You can also easily test UTF8 encoding on this page opens in new page http://www.hypergurl.com/urlencode.html ;  Note: switch encoding to UTF8, not ASCII

The 1609SMS gateway supports the use of alphanumeric senders (letters and / or numbers). Instead of a phonenumber the recipient of the text message sees - up to 11 characters - as the sender id.

Examples of scripts in various programming languages :

Programming language Name Explanation
PHP opens in new page  Fsockopen This is where you can find information on, a PHP function to address a url.
PHP opens in new page  Urlencode Here you can find information on urlencode, a PHP function for  encoding a url.
VB.net opens in new page  easyHTTP This is where you can find information on addressing the gateway via VB.net
A PHP example opens in new page  PHP example 

For a working PHP example :

 

Parameters :

Parameter

Explanation

Comment

clientuser

your username

Identical as the one you received for the sms module

clientpwd

your password

Identical as the one you received for the sms module ( you can encode this password by using opens in new page SHA-1 for additional security. ( only the use of 1 - case characters is allowed )

message

the text message

Note : the message should be urlencoded before you send it. (this is a test = this%20is%20a%20test)

to

the mobile number

A valid mobile number (always starts with the correct country code : for example (44701xxxxxxx)

sender

the sendername

a maximum of 11 characters (sendername)

 

 

 

Optional parameters

logging=ja

Logging functon

If you add logging=yes , all sms shipments will automatically be saved under the tab "history" within the sms module.

delivery=ja

Delivery reports

If you add delivery=yes , in case of a successful transmission, you receive sending OK + a smsID in return.
example : OK 1234567
Thereafter you can capture this SMS ID ,implement a call back function, and ask for the report.

type=long

The sending of long sms messages

Incase you add type=long , you can send messages over 160 characters. The message will be split into serveral text messages and subsequently being shown as a single message. You can deliver a message up to 459 characters, and we will split it up to a maximum of 3 messages. ( Note : Only 153 Characters can be used (the other 7 characters are used to indicate this is a "long sms").

test=yes

Testing the system

The system will conduct all the checks (correct username, password, message, sendername, ...) but effectively won't send an sms. No credits will be deducted.

 

Error codes :

If your message wasn't send successfully, the gateway will provide you with an error + nr. in return. Here you can find a list of errors:

Errorcode

Explanation

100

Username - value - is empty and cannot be empty

101

Password - value - is empty and cannot be empty

102

SMS message has no content

103

Mobile number has no content

104

No valid username and/or password combination

105

Message contains more characters (> 160 tekens) than allowed

106

No valid mobile number. A valid number always starts with the country code followed by the number : example 44701xxxxxxx

107

No valid countrycode. You cannot send text messages to this country. Please contact us so we can make this possible.

108

You do not have sufficiënt credits left

109

The sendername is empty

110

You are using a sender number, but it should always start with the + sign.

111

You are using a non valid sendername/username. This can be up to 12 characters.

112

You are using a non valid countrycode

113

Your sendername/number contains special characters not allowed on all networks.

114

No valid country code (country is not permitted).

115

Your account has been blocked because your payment has not been received (yet).

116

Your account has been blocked for distinct reasons. You can contact us for additional information.

117

This sendername is not allowed.

118

If you want to send a long text message (> 160 tekens) this may reach a maximum length of 3 messages, (max 153 characters per message) so, up to 459 characters.

119

For delivery of text messages to this country, we do not offer the option of sending long text messages (> 160 tekens).

120

There is a problem with our gateway. Please contact us.

150

Our module and services are currently unavailable because of sceduled maintenance

 

Request for delivery reports :

In order to receive the delivery reports, always use the parameter "delivery=yes". You will receive the answer OK + nr in return . Example OK 1234567

On this page you can retrieve the status :

http://217.19.227.48/module/gatewayrapport.php?smsid=1234567

The system provides a code in return according to the status of the message.

Deliverycode

Explanation

DELIVERED

The message was delivered successfully (endstatus)

NOT DELIVERED

The message was not delivered successfully (endstatus)

BUFFERED

The message was accepted by the operator, but not yet delivered to the recipient. The operator shall periodically attempt to deliver the message. This is a temporary status.

SUBMITTED

The message was delivered successfully to the operator, there is however no status available (yet).

REJECTED

The operator has rejected this message (endstatus)

NONE

This message has no delivery report available and therefore no known status.

 

Request for remaining amount of credits :

You can also retrieve the number of remaining credits to the gateway:

http://217.19.227.48/module/gateway.php?clientuser=USERNAME&clientpwd=PASSWORD&action=credits

This will return a certain number : example 476
This is the number of credits still remaining in your sms account.

 

Support :

Of course you can contact us if you have problems with the implementation of our gateway in your scripts. Send your questions / scripts to php-support@1609sms.com

To further test our gateway and unlock messages from your existing applications, open a open your test account test-account , and you will receive your username and password via email to be used as identification data to connect your scripts.

Or, contact us via chat, by clicking the live support button below.

Click here for online chat support

     © 2006-2009 1609SMS ®                                                                                                                                                                           SMS Inbound  |  HttP API Info