Developers section: generic interface

To submit messages from any programming language, you basically need to call an URL of the following style:
(split on to multiple lines for readability only)

Simple Text SMS

http://blue.smsrelay.com/cgi-bin/sendsms?
 &user=your_nickname
&password=your_password
&to=destination_number
&from=optional_source_phone_numer_or_name
&text=the_message

The phone number has to be in international format with a leading + sign. Of course the parameters have to be in URL encoded format. So a number of +12345 would be &to=%2B12345 because the + sign has to be quoted. Otherwise it would be looked as a space character.

Multi Destination Text SMS

to send SMS to multiple destinations, simply concatenate the destination numbers separated with a comma.

http://blue.smsrelay.com/cgi-bin/sendsms?
&user=your_nickname
&password=your_password
&to=destination_number1,destination_number2,destination_number3
&from=optional_source_phone_numer_or_name
 &text=the_message

Long Text SMS

To send SMS with text sizes longer than 160 characters you don't have to do anything special. If your message gets over 160 characters it is automatically split into chunks of 153 messages and prefixed with a concatenation header. Some phones will receive it as multiple SMS while others are able to reassemble it back into one large message.

Flash SMS

A flash SMS is an SMS which pops up directly on the screen of the phone. To do this simply append the following to your URL:

&mclass=1

This will instruct SMSRelay to send the message as FlashSMS (message class 1) which makes it display immediately on the phone.

Unicode SMS

A unicode SMS is sent when you add the following to the URL:

&coding=3

The content of the text field must contain the hexadecimal codes of the Unicode string.

Example

&text=%00%41%00%72%00%61%00%62%00%20%06%30%06%35%06%36
&coding=3

Binary SMS

&udh=....

This will instruct SMSRelay to send the message in BINARY form and prepending the universal data header. You can send long messages this way without splitting them into individual ones. SMSRelay does split them automatically for you.

Example (split on to multiple lines for readability only) sending our SMSRelay international input gate as a VCARD:

http://blue.smsrelay.com/cgi-bin/sendsms?
&user=your_username_here
&password=your_password_here
&to=your_phone_numer_here
&udh=%06%05%04%23%F4%00%00
&text=BEGIN:VCARD%0D%0AVERSION:2.1%0D%0AN:SMSRelay%0D%0ATEL;PREF:%2B41795169338%0D%0AEND:VCARD%0D%0A

Limiting Usage

&limit=....

This will instruct SMSRelay to send the message only if the charge resulting in sending the message is equal or lower than the limit

Delivery Report

&dlrmask=.... &dlrurl=

This will instruct SMSRelay to give you a delivery report back. A delivery report message tells you if the message has been successfully delivered to the handset (1), failed to be delivered (2) or could not be delivered in the first try and is now buffered (4) for retries on the SMSC. By specifying the sum of messages types you want to receive in &dlrmask you tell SMSRelay what types of reports you would like to get back from the system. Once we have a report for you, we will call the url specified on &dlrurl. The URL can include the following placeholders:

%P the phone number you sent the message to
%d the status. 1 = delivered, 2 = failed, 4 = buffered
%A the status text given back from SMSC.