If you are working on telephone solutions, please check
out the Ozeki VoIP SIP SDK.
It can be used to create VoIP client and server software. |
|
HTTP API for the Reporting function of Ozeki NG SMS Gateway
(available in version:
Ozeki NG SMS Gateway v4.1.22 or newer)
This method can be used to query the messages that are sent and received by the Ozeki
NG SMS Gateway software. With the help of different parameters it becomes possible
to filter the messages by operator, user, and date. Therefore it is also possible
to query the sent and received messages from an external application.
Description
By using the reporting function (if it is configured in the NG), the following data can be queried:
- the sender user of the SMS message
- the service provider through which the message went
- the exact time when the message was sent
- the content of the SMS message
Important!
To use the reporting function, it needs to be allowed in the Ozeki NG SMS Gateway. For the
exact configuration steps, please visit the following website:
http://ozekisms.com/index.php?owpn=378
Example URL Request
http://127.0.0.1:9501/api?action=reporting&username=admin&password=abc123&repDirection=in&toExport=summary
Example Response
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 246
<?xml version="1.0" encoding="utf-8"?>
<response>
<action>reporting</action>
<data>
<user>
<username>admin</username>
<messages>4</messages>
</user>
</data>
</response>
Request parameters
Parameter |
Description |
Possible values |
Example |
M/O* |
action |
Specifies the HTTP API command sendmessage |
reporting |
action=reporting |
M |
username |
Specifies the username. The username and password parameters are
used to authenticate the user. The value must be
urlencoded.
|
admin (the admin user's username)
|
username=admin |
M |
password |
Specifies the password. The username and password parameters are used
to authenticate the user. The value must be
urlencoded.
|
string value, maximum length is 16 characters (the admin user's password)
|
password=abc123 |
M |
repDirection |
Specifies whether we would like to list the incoming or the outgoing
messages.
urlencoded.
|
in, out
|
repDirection=in |
M |
toExport |
Specifies what the got back xml should contain. A summary of the
number of the messages or the messages themselves.
|
summary, messages
|
toExport=messages |
M |
repUser |
Specifies which user's data we would like to list. In case we do
not define the user, the admin user is being listed automatically.
|
string, maximum 16 characters
|
repUser=testuser |
O |
repOperator |
Specifies the name of the service provider the data of which we would
like to know.
|
string value, maximum 16 characters
|
repOperator=HTTPServer0 |
O |
repStartTime |
Specifies the date after which the sent and received messages we would
like to know about. The value must be YYYY-MM-DD hh:mm::ss
urlencoded.
|
date in urlencoded form: YYYY-MM-DD hh:mm::ss
|
repStartTime=2011-11-29%2011:00:00 |
O |
repStopTime |
Specifies the date before which the sent and received messages we would
like to know about. The value must be YYYY-MM-DD hh:mm::ss
urlencoded.
|
date in urlencoded form: YYYY-MM-DD hh:mm::ss
|
repStartTime=2011-11-29%2011:00:00 |
O |
Dig deeper!
People who read this also read...
Reporting
Reporting Mysql Table Layout
Reporting Oracle Table Layout
Advanced traffic queries
Next page:
Dynamic SMPP parameters
|