(available in version: Ozeki NG SMS Gateway v3.0.1 or newer)
This method can be used to get information about how many messages can
a user send. The credit limit of the user is modified if a cost is defined
for a route. This way the system can be setup to charge the user for both
incoming and outgoing messages. It is also possible to set negative costs
for various routes, which is a good option for premium rated services. Negative
costs can increase the balance of a user.
For 127.0.0.1, you should substitute the host name or the IP address of the
computer your SMS gateway is installed on. The port number 9501 is the
default HTTP port number of the Ozeki NG SMS gateway. It is should not be changed.
The username and the password should be substituted for "UUUUU" and "PPPPP". The
username and password identifies the user who wants to get information about
the balance. AAAAA should be substituted for the username that specifies the
account you want to query information about. For example if the admin user
would like to find out what is the balance of a user called "john", he would
substitute "admin" for "UUUUU", "abc123" for "PPPPP", which is the username
and password of the admin account, then he would substitute "john" for AAAAA.
In this case the request would look like this:
The admin user can query information about all accounts in the system. A user
without administrative privileges can query information about his account
only. The useraccount parameter is optional. If it is not specified,
information will be returned from the account of the logged in user.
Request parameters
Parameter
Description
Possible values
Example
M/O*
action
Specifies the HTTP API command
getcredits
action=getcredits
M
username
Specifies the username.
The username and password parameters are used to
authenticate the user. Once the user is authenticated
messages will be downloaded from his inbox. The value
must be urlencoded.
string value, maximum length is 16 characters
username=admin
M
password
Specifies the password.
The username and password parameters are used to
authenticate the user. Once the user is authenticated
messages will be downloaded from his inbox.
The value
must be urlencoded.
string value, maximum length is 16 characters
password=abc123
M
useraccount
Specifies the name of the user account, whose balance is queried.
If this parameter is not specified it's value is set to the username
parameter.
string value, maximum length is 16 characters
useraccount=john
O
* M = Mandatory parameter, O = Optional parameter
Response parameters
(xml response format)
Parameter
Description
Possible values
Example
account
Contains the balance of a user account in an XML structure