(available in version: Ozeki NG SMS Gateway v3.0.1 or newer)
This method can be used to modify the balance of a user account. The credit
limit of a user account specifies how many messages the user can send and receive. You can
use the setcredits method to set the balance to a specific value.
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.
The username and the password of the admin account should be substituted for
"UUUUU" and "PPPPP". No other users can modify the credit limits of an account.
The username of the account whose balance is about to be updated, should be
substituted for AAAAA. The new balance should be specified in the newbalance
parameter (BBBBB).
If the newbalance parameter is left empty the balance will not be modified.
Request parameters
Parameter
Description
Possible values
Example
M/O*
action
Specifies the HTTP API command
setcredits
action=setcredits
M
username
This should be set to "admin", since only the admin
account can update credit information in the server.
string value, maximum length is 16 characters
username=admin
M
password
This should be set to the "password" of admin, since only the admin
account can update credit information in the server. The password should
be urlencoded.
string value, maximum length is 16 characters
password=abc123
M
useraccount
Specifies the name of the user account, whose balance is going to
be changed. If this parameter is not specified, the balance of the
admin account will be changed.
string value, maximum length is 16 characters
useraccount=john
O
newbalance
Specifies the new balance. The balance of the user account
identified by the useraccount parameter will be changed to this value.
If this parameter is not specified, the balance of the user account
will not be changed.
int value
newbalance=500
M
* 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