Difference between revisions of "List Scheduled SMS"
From Boxis.net API Docs
(→SMS Function: getHistory) |
(→Example URL with POST values) |
||
(6 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
=SMS Function: getScheduledSMS= | =SMS Function: getScheduledSMS= | ||
− | With this command, you are able to view | + | With this command, you are able to view sms to send scheduled list |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | === 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 'getScheduledSMS' value | ||
+ | |||
+ | |||
+ | == Example URL with POST values == | ||
+ | |||
+ | <pre> | ||
+ | http://api.boxis.net/ | ||
+ | POST: version=1.0&returntype=xml$timestamp=1337853550&username=your@mail.com&authcode=1234567890§ion=sms&action=getScheduledSMS | ||
+ | </pre> | ||
+ | |||
+ | == Output params == | ||
==== Example in XML (Success) ==== | ==== Example in XML (Success) ==== | ||
Line 65: | Line 60: | ||
</pre> | </pre> | ||
− | ==== Example in | + | ==== Example in JSON (Success) ==== |
<pre> | <pre> | ||
Line 81: | Line 76: | ||
</pre> | </pre> | ||
− | ==== Example in | + | ==== Example in JSON (Error) ==== |
<pre> | <pre> | ||
Line 87: | Line 82: | ||
"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 = 'getScheduledSMS'; | ||
+ | $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 14:58, 26 October 2012
Contents
SMS Function: getScheduledSMS
With this command, you are able to view sms to send scheduled list
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 'getScheduledSMS' value
Example URL with POST values
http://api.boxis.net/ POST: version=1.0&returntype=xml$timestamp=1337853550&username=your@mail.com&authcode=1234567890§ion=sms&action=getScheduledSMS
Output params
Example in XML (Success)
<?xml version="1.0" encoding="UTF-8"?> <return> <result>1</result> <resulttxt>success</resulttxt> <scheduled> <sms1> <sms_id>133655674531563000004070</sms_id> <sender>boxis.net</sender> <reciptient>48511131563</reciptient> <date>2012-05-09 11:28:00</date> <credit>1</credit> </sms1> </scheduled> <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":{ "scheduled":{ "sms1":{ "sms_id":"133655674531563000004070", "sender":"boxis.net", "reciptient":"48511131563", "date":"2012-05-09 11:28:00", "credit":"1"}} "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 = 'getScheduledSMS'; $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); } /*