Difference between revisions of "Get Credit Limit"
From Boxis.net API Docs
(→Example URL with POST values) |
|||
(8 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
+ | |||
=SMS Function: getCreditLimit= | =SMS Function: getCreditLimit= | ||
With this command, you are able to get available credit. | With this command, you are able to get available credit. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | == Input params == | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === Output params | + | *'''version'''::String - ''API version (e.g. '1.0')'' |
+ | |||
+ | *'''timestamp'''::String - ''Sequence of characters, denoting the date and time (e.g '1336553826')'' | ||
+ | |||
+ | *'''username'''::String - ''User e-mail address (e.g 'mail1@example.com')'' | ||
+ | |||
+ | *'''authcode'''::String - '' md5 hash consisting of the concatenation of timestamp and user_key (e.g md5(1336553826BX3KwWU2SuqvoEWnjYmOibf'))'' | ||
+ | |||
+ | *'''section'''::String - ''API module name. Use 'sms' value | ||
+ | |||
+ | *'''action'''::String - ''API module function. Use 'getCreditLimit' value | ||
+ | |||
+ | |||
+ | == Example URL with POST values == | ||
+ | |||
+ | <pre> | ||
+ | http://api.boxis.net/ | ||
+ | POST: version=1.0&returntype=xml×tamp=1337853135&username=your@mail.com&authcode=1234567890§ion=sms&action=getCreditLimit | ||
+ | </pre> | ||
+ | |||
+ | == Output params == | ||
==== Example in XML (Success) ==== | ==== Example in XML (Success) ==== | ||
Line 74: | Line 54: | ||
</pre> | </pre> | ||
− | ==== Example in | + | ==== Example in JSON (Success) ==== |
<pre> | <pre> | ||
Line 84: | Line 64: | ||
</pre> | </pre> | ||
− | ==== | + | ==== Example in JSON (Error) ==== |
+ | |||
<pre> | <pre> | ||
− | {"result":" | + | {"result":"0", |
− | "resulttxt":" | + | "resulttxt":"Error: {error description}", |
− | + | ||
− | + | ||
"timestamp":1335777400} | "timestamp":1335777400} | ||
</pre> | </pre> | ||
− | |||
+ | == Example using our PHP Class == | ||
<pre> | <pre> | ||
− | + | /* API LOGIN DETAILS */ | |
− | + | $email = 'your@mail.com'; // your username | |
− | + | $apikey = '1234567890'; // your apikey | |
+ | |||
+ | /* API COMMAND DETAILS */ | ||
+ | $apitype = 'sms'; | ||
+ | $command = 'getCreditLimit'; | ||
+ | $params = array(); | ||
+ | |||
+ | /* PROCESS THE ACTION */ | ||
+ | $boxisAPI = new BoxisAPIConnection($email, $apikey); | ||
+ | $return = $boxisAPI->call($apitype, $command, $params, $timestamp); | ||
+ | |||
+ | /* TIMESTAMP SYNCHRONIZATION (JSON EXAMPLE) | ||
+ | if($return['timestamperror']) { | ||
+ | $timestamp = $return['timestamp']; | ||
+ | $return = $boxisAPI->call($apitype, $command, $params, 'json', $timestamp); | ||
+ | } | ||
+ | */ | ||
+ | |||
+ | /* TIMESTAMP SYNCHRONIZATION (XML EXAMPLE)*/ | ||
+ | /* | ||
+ | if($return->timestamperror) { | ||
+ | $timestamp = $return->timestamp; | ||
+ | $return = $boxisAPI->call($apitype, $command, $params, 'xml', $timestamp); | ||
+ | } | ||
+ | /* | ||
+ | |||
</pre> | </pre> |
Latest revision as of 13:57, 26 October 2012
Contents
SMS Function: getCreditLimit
With this command, you are able to get available credit.
Input params
- version::String - API version (e.g. '1.0')
- timestamp::String - Sequence of characters, denoting the date and time (e.g '1336553826')
- username::String - User e-mail address (e.g 'mail1@example.com')
- authcode::String - md5 hash consisting of the concatenation of timestamp and user_key (e.g md5(1336553826BX3KwWU2SuqvoEWnjYmOibf'))
- section::String - API module name. Use 'sms' value
- action::String - API module function. Use 'getCreditLimit' value
Example URL with POST values
http://api.boxis.net/ POST: version=1.0&returntype=xml×tamp=1337853135&username=your@mail.com&authcode=1234567890§ion=sms&action=getCreditLimit
Output params
Example in XML (Success)
<?xml version="1.0" encoding="UTF-8"?> <return> <result>1</result> <resulttxt>success</resulttxt> <params> <credit>186</credit> </params> <timestamp>1336558351</timestamp> </return>
Example in XML (Error)
<?xml version="1.0" encoding="UTF-8"?> <return> <result>0</result> <resulttxt>error: {error description}</resulttxt> <timestamp>1335767184</timestamp> </return>
Example in JSON (Success)
{"result":"1", "resulttxt":"success", "params":{ "sms_id":"133655724631563000002130"} "timestamp":1335777400}
Example in JSON (Error)
{"result":"0", "resulttxt":"Error: {error description}", "timestamp":1335777400}
Example using our PHP Class
/* API LOGIN DETAILS */ $email = 'your@mail.com'; // your username $apikey = '1234567890'; // your apikey /* API COMMAND DETAILS */ $apitype = 'sms'; $command = 'getCreditLimit'; $params = array(); /* PROCESS THE ACTION */ $boxisAPI = new BoxisAPIConnection($email, $apikey); $return = $boxisAPI->call($apitype, $command, $params, $timestamp); /* TIMESTAMP SYNCHRONIZATION (JSON EXAMPLE) if($return['timestamperror']) { $timestamp = $return['timestamp']; $return = $boxisAPI->call($apitype, $command, $params, 'json', $timestamp); } */ /* TIMESTAMP SYNCHRONIZATION (XML EXAMPLE)*/ /* if($return->timestamperror) { $timestamp = $return->timestamp; $return = $boxisAPI->call($apitype, $command, $params, 'xml', $timestamp); } /*