时代互联接口模式源程序 Version 2.4
 
 
= 域名接口模式函数说明 =
  为方便大家使用,我们还提供了部分常用函数供大家调用,这些函数作为接口类的基类函数在WEB-INF/lib/smsapi.jar文件下的已经写好,用以实现“短信操作”的接口组件:SMS.class (com.todaynic.client.mobile 包),这个组件由JAVA写并编译而成,操作组件除了现有的以外,其它的将会陆续发布,请留意我们的最新发布信息。
下面以注册短信的返回信息(XML格式)来具体说明这些函数的用法。
<?xml version="1.0" encoding="GB2312"?>
<scp xmlns:contact="urn:todaynic.com:contact" xmlns:host="urn:todaynic.
com:host" xmlns:domain="urn:todaynic.com:domain" xmlns:registrant="urn:todaynic.com:registrant">
    <response>
      <result code="2000">
        <msg>Command complateted successfully</msg>
      </result>
      <resdata>
        <id>42683</id>
        <prod>100</prod>
        <password>111111</password>
        <space>100</space>
        <dtcreate>2008-1-7 15:33:11</dtcreate>
        <dtexp>2008-1-7</dtexp>
      </resdata>
    </response>
    <security>
      <sltrid>1112859191704</sltrid>
    </security>
</scp>   
 一、getCode()方法 继承于 SendInfoXML
说明: 在执行SMS的'短信操作'方法后调用该方法
如: String code = sms.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"//操作错误,如不能添加、删除文件等

 二、getMsg()方法 继承于 SendInfoXML
说明:在执行SMS的'短信操作'方法后调用该方法
如: String code = sms.getMsg();


使用该方法可以得到<msg>******</msg>中*****的内容。

 三、getRespData() 方法继承于SendInfoXML
说明:在执行SMS的'短信操作'方法后调用该方法
如: Hashtable result = sms.getRespData();

使用该方法可以成功返回'短信操作'后返回的结果包。

 四、getRecieveXml()和 getSendXml() 方法继承于 SendInfoXML
说明:在执行SMS的'短信操作'方法后调用该方法

如:
<%
......
String sms.getSendXml();

String sms.getRecieveXml();

.....

%>


getSendXML()
该成员保存的是完整的发送xml信息。
getRecieveXml()
该成员保存的是完整的返回XML信息。

 五、SMS 类的'短信操作'方法:
构造函数public SMS(Hashtable cfg)

参数说明:
Hashtable cfg 用来传入服务器地址、服务器端口号、用户名、帐号
构造时请按如下顺序将键值对放入Hashtable中去:
键名:
VCPSERVER 服务器地址
VCPSVPORT 服务器端口号
VCPUSERID 用户帐号
VCPPASSWD 密码

public boolean sendSMS(String mobile, String message, String time)
功能:发送短信
参数:
String mobile   要发送的手机号码(多个手机用","分隔。一次最多99个号码)
String message    -短信内容,一条短信最大长度,视所选择的通道而不同。(通道二:64个字;即时通道:50个字)
String time  - 短信发送的时间(值为空或比当前时间小即是即时发送)。
String apitype   (通道选择 0:默认通道; 2:通道2; 3:即时通道)
返回值:是否成功
public boolean infoSMSAccount()
功能:查询余额
返回值:是否成功

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