Difference between revisions of "Calculate Credits"
From Boxis.net API Docs
								
												
				|  (Created page with "=SMS Function: calculateCredits=  With this command, you are able to get how many credits you need to send a message.  === Input params === {| |- | - '''version''' (string) ''...") | 
| (No difference) | 
Revision as of 12:12, 9 May 2012
Contents
SMS Function: calculateCredits
With this command, you are able to get how many credits you need to send a message.
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 'calculateCredits' value | 
| - recipients_count (Integer) Number of message recipients | 
| - content (Integer) The message text | 
| - fast (Boolean)  - optional Setting this parameter to 0 or 1 | 
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}
