iSMS Receive API

HTTP Receive API – Non-Polling Mode

When the protocol is HTTP, the “Receive API request” is an HTTP POST packet.
POST Packet Format with Authentication
POST /cgi-bin/postquery.cgi HTTP/1.1
HOST: 192.168.2.2:80
User-Agent: MultiModem iSMS/1.40
Accept: text/xml, application/xml,
application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,
application/msword, application/vnd.ms-powerpoint, image/png, */*
Accept-Language: en-us; en;q=0.50
Accept-Encoding: gzip, deflate
Accept-Charset: ISO-8859-1, utf-8;q=0.7, *;q=0.7
Keep-Alive: 300
Connection: keep-alive
Content-Type: application/x-www-form-urlencoded
Content-Length: 395
username=SMSFINDER&password=SMSFINDER&XMLDATA=%3C%3Fxml%20version%3D%221.0%22%20encoding%3D%22ISO-8859-1%22%3F%3E%0D%0A%3CMessageNotification%3E%0D%0A%3CModemNumber%3E%2B2%3A19525945
092%3C%2FModemNumber%3E%0D%0A%3CSenderNumber%3E%2B919844895692%3C%2FSenderNum
ber%3E%0D%0A%3CDate%3E08%2F03%2F14%3C%2FDate%3E%0D%0A%3CTime%3E12%3A53%3A09%3C
%2FTime%3E%0D%0A%3CMessage%3ETest%0D%0A%0D%3C%2FMessage%3E%0D%0A%3C%2FMessage
Notification%3E%0D%0A
Appendix A – Application Programming Interface (API)
Multi-Tech Systems, Inc. MultiModem® iSMS User Guide for Administrators 91
POST Packet Format without Authentication
POST /cgi-bin/postquery.cgi HTTP/1.1
HOST: 192.168.2.2:80
User-Agent: MultiModem iSMS/1.40
Accept: text/xml, application/xml,
application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,
application/msword, application/vnd.ms-powerpoint, image/png, */*
Accept-Language: en-us; en;q=0.50
Accept-Encoding: gzip, deflate
Accept-Charset: ISO-8859-1, utf-8;q=0.7, *;q=0.7
Keep-Alive: 300
Connection: keep-alive
Content-Type: application/x-www-form-urlencoded
Content-Length: 346
XMLDATA=%3C%3Fxml%20version%3D%221.0%22%20encoding%3D%22ISO-8859-
1%22%3F%3E%0D%0A%3CMessageNotification%3E%0D%0A%3CModemNumber%3E%2B2%3A19525945
092%3C%2FModemNumber%3E%0D%0A%3CSenderNumber%3E%2B919844895692%3C%2FSenderNum
ber%3E%0D%0A%3CDate%3E08%2F03%2F14%3C%2FDate%3E%0D%0A%3CTime%3E12%3A55%3A54%3C
%2FTime%3E%0D%0A%3CMessage%3ETest%0D%0A%0D%3C%2FMessage%3E%0D%0A%3C%2FMessage
Notification%3E%0D%0A
Note:
If authentication is disabled, POST DATA contains XMLDATA=[urlencoded(XML)]
If authentication is enabled, POST DATA contains username=user&passwd=user&
XMLDATA=[urlencoded(XML)]
The server authenticates the message from MultiModem iSMS using the username/password XML data:
<?xml version=”1.0″ encoding=”ISO-8859-1″?>\r\n
<MessageNotification>\r\n
<ModemNumber>2:19525945092</ModemNumber>\r\n
<SenderNumber>6754535645</SenderNumber>\r\n
<Date>08/03/10</Date>\r\n
<Time>09:05:30</Time>\r\n
<Message>Here is a test message</Message>\r\n
</MessageNotification>\r\n
-or-
<?xml version=”1.0″ encoding=”ISO-8859-1″?>\r\n
<MessageNotification>\r\n
<ModemNumber>2:19525945092</ModemNumber>\r\n
<SenderNumber>8767654534</SenderNumber>\r\n
<Date>08/03/07</Date>\r\n
<Time>08:07:20</Time>\r\n
<Message>Test message 1</Message>\r\n
</MessageNotification>\r\n
<MessageNotification>\r\n
<ModemNumber>3:</ModemNumber>\r\n
<SenderNumber>9876754534</SenderNumber>\r\n
<Date>08/03/13</Date>\r\n
<Time>10:10:36</Time>\r\n
<Message>Test message 2</Message>\r\n
</MessageNotification>\r\n

Notes:
• The MultiModem iSMS accommodates two messages at the maximum in one POST
message.
• The MultiModem iSMS waits for an OK response from the HTTP server; it will timeout in
30 seconds.
• If receiving modem’s SIM number is configured then <ModemNumber> field has modem
index:SIM number. If receiving modem’s SIM number is not configured then
<ModemNumber> field has modem index: