时代互联接口模式源程序 Version 2.5
 
 
= 接口函数说明 =
为方便大家使用,我们还提供了部分常用函数供大家调用。下面以发送SMS短信的返回信息(XML格式)来具体说明这些函数的用法。
<?xml version="1.0" encoding="GB2312"?>
  <scp xmlns="urn:mobile:params:xml:ns:mobile-1.0"
       xmlns:user="urn:mobile:user"
       xmlns:sms="urn:mobile:sms" >
  <command>
      <action>SMS:sendSMS</action>
      <sms:mobile>13003000009,13033003000</sms:mobile>
      <sms:message>ZmRnaGRmZw==</sms:message>
      <sms:datetime></sms:datetime>
      <sms:smstype>0</sms:smstype>
      <sms:smsabout></sms:smsabout>
      <sms:sender></sms:sender>
      <sms:issys>false</sms:issys>
      <sms:staffuser>zhou</sms:staffuser>
  </command>
  <security>
      <smsuser>ms117</smsuser>
      <cltrid>11379973176790</cltrid>
      <login>b88e263b4bf37bc8b241b0599dee4423</login>
  </security>
</scp>
 一、getCode()方法
<?
include "sms.inc.php";
$newclient= new SMS();
………
………
$respxml=$newclient->sendSMS($mobile, $message, $time);
    $code=$newclient->getCode();
?>
  使用该方法可以得到四位数的code信息。不同的数字代表不同不同的含义,具体如下
2000 "Command complateted successfully" //操作成功
3000 "Datebase error"//数据库错误(插入\删除等)
4000 "Client error"//客户未知错误
4001 "Xml parse error"//xml错误
4002 "Authorization error"//授权错误(用户不存在、密码错误、权限不足等)
4003 "No data post to server"
4004 "Object does not exist"//函数不存在
4300 "Account error"//财务错误
4400 "Parameter error"//参数错误
5000 "Server error"
5001 "Unable connet to remote server"
5002 "Server no data return"
5003 "Server other error"
6000 "optation error"//操作错误,如不能添加、删除文件等

 二、toArray()方法
<?
include "sms.inc.php";
$newclient= new SMS();
………
………
$respxml=$newclient->sendSMS($mobile, $message, $time);
    $respArr =$newclient->toArray($content);
?>
  使用该方法可以将服务器返回的XML数据转化为二维数组形式。 比如:
$mess=$respArr["msg"][0];
$idmessage=$respArr["sms:idmessage"][0];
参数$content默认为“response”,也可以设置为“result”,"resdata"等等,或者不填也可以,默认为不填,并得到这些标签下的数据值。
 三、responseXML成员
<?
include "sms.inc.php";
$newclient= new SMS();
………
………
$respxml=$newclient->sendSMS($mobile, $message, $time);
    $respxml=$newclient->responseXML;
?>
  该成员保存的是完整的返回XML信息。
 四、sendXML成员
<?
$newclient= new SMS();
………
………
$respxml=$newclient->sendSMS($mobile, $message, $time);
    $sendxml=$xmlcl->sendXML;   
?>
  该成员保存的是完整的发送XML信息。
 五、函数说明
发送短信
  sendSMS($mobile, $message, $time, $apitype)
  参数:$mobile - 要接收短信的手机号码,一次最多99个手机号码并用“,”分隔;
       $message - 短信内容,一条短信最大长度,视所选择的通道而不同。(通道二:64个字;即时通道:50个字)
       $time - 短信发送的时间(值为空或比当前时间小即是即时发送)。
       $apitype - 短信发送的通道。( 0:默认通道; 2:通道二; 3:即时通道)
  返回:服务器返回的XML(返回的信息用toArray()方法提取)
     successphone - 发送成功的手机号码
     failephone - 发送失败的手机号码
     successnum - 成功发送的手机号码个数
     idmessage - 短信编号
    

查询短信账户余额
   infoSMSAccount()
  返回:服务器返回的XML(返回的信息用toArray()方法提取)
  返回变量:
     smsaccount - 账户余额,单位为条数
    

回复短信查询
   receiveSMS()
  返回:服务器返回的XML
  返回变量:
     id - 回复短信ID,大于0表示有回复短信,小于等于0表示失败
     src - 回复手机
     dst - 接收对象,参考值
     time - 回复时间,格式如0000-00-00 00:00:00
     message - 回复内容,为base64加密后的字符串,需解码
     err - 错误信息,成功则为空,参考值
    
   
时代互联 版权所有