为方便大家使用,我们还提供了部分常用函数供大家调用。下面以发送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 - 错误信息,成功则为空,参考值
|
|