Difference between revisions of "Calculate Credits"

From Boxis.net API Docs
Jump to: navigation, search
(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) ''...")
 
(Input params)
Line 31: Line 31:
 
|-
 
|-
 
| - '''fast''' (Boolean)  - optional
 
| - '''fast''' (Boolean)  - optional
''Setting this parameter to 0 or 1  
+
''Setting this parameter 1 when message will be sent in fast mode
 
|-
 
|-
 
|}
 
|}

Revision as of 13:13, 9 May 2012

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 1 when message will be sent in fast mode

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}