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=2378

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=2020-11-29%2011:00:00	O

More information

Service Provider Connection Handling | Dynamic SMPP parameters