HTTP API for developers (MINI HOWTO)

How to send an SMS message

To send an SMS message you can paste the following URL into your webbrowser:

http://127.0.0.1:9501/httpapi?action=sendMessage&username=admin&password=abc123&recipient=06203105366&messageData=hello
or you can use an HTML form to send a message:
<form action="http://127.0.0.1:9501/ozeki" method="GET">
    <input type="hidden" name="_charset_">
    <input type="hidden" name="action" value='sendMessage'>
    <input type="hidden" name="username" value="admin">
    <input type="hidden" name="password" value="abc123">
    <input type="hidden" name="messageType" value='SMS:TEXT'>
    <table>
        <tr><td>Recipient</td><td><input type="text" name="recepient"></td></tr>
        <tr><td>Message</td><td><textarea name="messageData" rows=5 cols=40></textarea></td></tr>
        <tr><td> </td><td><input type="submit" value="  OK  "></td></tr>
    </table>
</form>
Parameters:

Parameter Description Mandatory Possible values Example
action Specifies the HTTP API command Mandatory sendMessage action=sendMessage
originator Specifies the recipient phone number Optional Telephone number in local number format (e.g.06201234567).
Telephone number in international number format (e.g.+36201234567)
An alphanumeric sender address (e.g.ozeki)
The value must be encoded in UTF8 and must be urlencoded.
originator=%2B36201112222
recipient Specifies the recipient phone number Mandatory Telephone number in local number format (e.g.06201234567).
Telephone number in international number format (e.g.+36201234567)
More then one recipient addresses can be separated by a colon (e.g.: +36201234567,+36202222222)
The value must be urlencoded.
recipient=%2B36201234567
messageType Specifies the message type Optional The format of the SMS message based on the OZEKI Message Type specification.
Common message types are:
SMS:TEXT
SMS:TEXT:CLASS0
SMS:TEXT:CLASS1
SMS:TEXT:CLASS2
SMS:TEXT:CLASS3
SMS:TEXT:GSM7BIT
SMS:TEXT:GSM7BIT:CLASS0
SMS:TEXT:GSM7BIT:CLASS1
SMS:TEXT:GSM7BIT:CLASS2
SMS:TEXT:GSM7BIT:CLASS3
SMS:TEXT:UCS2
SMS:TEXT:UCS2:CLASS0
SMS:TEXT:UCS2:CLASS1
SMS:TEXT:UCS2:CLASS2
SMS:TEXT:UCS2:CLASS3
SMS:INDICATION
SMS:INDICATION:FAX
SMS:INDICATION:EMAIL
SMS:INDICATION:VOICEMAIL
SMS:BINARY
SMS:CALLERICON
SMS:OPLOGO
SMS:PICTUREMESSAGE
SMS:RINGTONE
SMS:VCARD
SMS:VCalendar
SMS:WAPPUSH

The default value is SMS:TEXT
messageType=SMS:TEXT
messageData Specifies the text or the data of the SMS message Mandatory The value must be encoded in UTF8 and must be urlencoded. messageData=Hello+World
_charset_ Specifies the charset of the encoded data (if not specified utf-8 will be assumed) Optional Newer browsers should set the value of _charset_ automatically. If your browser doesnt support this feature you can set is manually to:
utf-8
windows-1250
iso-8859-1
iso-8859-2
...
_charset_=iso-8859-2