Poseidon2
– Family manual
HW group
www.HW-group.com
94 / 104
netGSM protocol for programmers
Poseidon SOAP Service Interface (PSSI)
Configure hostname/port on HWg-SMS-GW where the service request will be sent.
Services (common API, SOAP interface)
Service
Functions
Parameters
Result
QueueAdd
put, put into the queue
XML with data, cmd=SMS,
Call
rslt=0, id=nnn: ID of the
record
QueuePick
get, get from the queue
-
XML with data
QueueStatus
info about the queue
queue type:qRfid, qGsmOut,
qGsmIn
what about
'list'
for
IDs ?
max=5, cnt=2, missed=0
RecordStatus
info about the request
id=nnn
for example retry=5
RecordDelete
request cancellation
id=nnn
rslt=0: OK
NotificationEvent
something was received
XML with data
Command
(action?, for example a request of
values)
XML with data
ServiceStatus
info about the service
-
rslt=disabled
netGSM
SMS sending or drop-call requests. An ID is assigned after the request is queued, with which it is
possible to ask for the request state.
Sent commands are
QueueAdd queue=qGsmOut, cmd={SMS|Call}
, phone number and a
message text, or cmd=ringNotify, phone number. Reply is rslt=0, id=nnn: request was placed into
queue, or rslt=err_no: request was not placed into queue
If SMS or drop-call is received: NotificationEvent, v xml cmdType, phoneNumber[, message text]
Communication examples
Every following communication has to be put between the following tags (instead of Data comment):
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:pos="poseidonService.xsd">
<soapenv:Header/>
<soapenv:Body>
<!-- Data -->
</soapenv:Body>
</soapenv:Envelope>
