Get Credit Limit: Difference between revisions

From Boxis.net API Docs
Jump to navigation Jump to search
No edit summary
No edit summary
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 ===
{|
|-
| - '''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
|-
|}


=== Output params ===
== 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
 
 
== Output params ==


==== Example in XML (Success) ====
==== Example in XML (Success) ====
Line 53: Line 47:
</pre>
</pre>


==== Example in Json (Success) ====
==== Example in JSON (Success) ====


<pre>
<pre>
Line 63: Line 57:
</pre>
</pre>


==== Example in Json (Error) ====
==== Example in JSON (Error) ====


<pre>
<pre>
Line 69: Line 63:
  "resulttxt":"Error: {error description}",
  "resulttxt":"Error: {error description}",
  "timestamp":1335777400}
  "timestamp":1335777400}
</pre>
== Example using our PHP Class ==
<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);
</pre>
</pre>

Revision as of 10:57, 24 May 2012

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


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);