时代互联接口模式源程序 Version 2.4
 
 
= 接口模式配置说明(java 版) =
为给广大短信用户提供一个更强大的短信业务平台,时代互联隆重推出API接口模式,实现与时代互联SMS短信实时在线发送接口的对接,您只需简单完成信息填写,就可以使网站实现发送短信、查询帐号余额等功能,简单,快捷。

= 接口模式系统要求 =
要使用本接口演示程序,你所必需的配置为:
  • 服务器或者虚拟主机必须支持JDK1.5(如:Tomcat|weblogic等)
  • 将下载包解压缩到Tomcat 或其它的Web服务器的执行目录(webapps)下, 然后按下面步骤配置

= 接口模式配置说明 =
下载并解压缩开发、演示程序包,并确认拥有符合接口模式要求的系统后,你所需要做的唯一修改仅仅是配置接口服务器、端口、用户名和密码;
安装并配置了上面的两种必备之后,使用默认网站或新建一个网站目录,您选择演示程序放到服务器的应用程序执行目录(如:webapps)中。

1、解压后,直接把其中的演示程序包smsdemo 拷贝到您的服务器(如tomcat)或者虚拟主机的web应用执行目录(webapps)下。
2、请把/WEB-INF/下的文件,拷贝到你服务器(如tomcat)或者虚拟主机的/WEB-INF/目录下。
3、请注意:配置您解压缩后的程序目录中WEB-INF/classes/VCPConfig.ini 文件。
请打开解压缩后的程序根目录下,在其中可以找到一个名为“WEB-INF/classes/VCPConfig.ini”的文件,该文件中有四个变量,分别为:
  VCPSERVER (接口服务器):在value里改成我们公布的服务器接口;
VCPSVPORT (服务器端口):请修改成我们公布的端口;
VCPUSERID (短信帐号):短信的真实或测试帐号;
VCPPASSWD (验证密码):短信的真实或测试的密码;
  一、VCPSERVER(接口服务器)如何配置?
  在测试环境,使用的接口服务器为:
testxml.todaynic.com
即"VCPConfig.ini"第一行应该配置为:
VCPSERVER=testxml.todaynic.com
测试完成后,在真实环境中,,使用的接口服务器为
sms.todaynic.com
即"VCPConfig.ini“第一行应该配置为:
VCPSERVERsms.todaynic.com
 二、VCPSVPORT(端口)如何配置?
 
在测试环境和真实环境,使用的接口均为20002;即"VCPConfig.ini"第二行应该配置为:
VCPSVPORT = 20002

 三、$vcpuser(代理号)如何配置?
 
在这为时代互联为您提供一个测试帐号,将"config.inc.php"第三行和第四行配置为:
VCPUSERID = ms1166 (请填写我们提供的测试帐户或真实帐号)
VCPPASSWD = odqymj (请填写我们提供的测试密码或真实密码)

 四、如果根目录已经有了 WEB-INF/Config.ini 这个文件该如何处理?
 
需要替换覆盖原来的 VCPConfig.ini 就可以了。
配好后格式如:
VCPSERVER=testxml.todaynic.com
VCPSVPORT=20002
VCPUSERID=ms1166
VCPPASSWD=odqymj

 五、常见问题解答
 
1、 如何放置WEB-INF/class、WEB-INF/lib目录下的文件
WEB-INF/lib 下有filter.jar、jdom.jar和smsapi.jar 都是API开发包
请将解压后WEB-INF/lib下的文件全部拷到您webapp下的WEB-INF/lib
请将解压后WEB-INF/class下的VCPConfig.ini 文件拷到您webapp下的WEB-INF/class下,并按照说明进行更改
2、 认证失败(Authorization error)?
确保在真实的服务器下使用真实的帐号和密码,或在测试的服务器下使用测试的帐号和密码
确保输入的帐号和密码正确;
3、 为何成功发送却收不到短信?
您可能没有使用真实的服务器或真实的帐号;
网络可能有些延迟,换个时间重试。
4、 测试服务器与真实服务器的区别?
测试服务器,只是一个模拟的环境,用来查看返回信息和调试程序,不会真正发送到手机上,也不会扣除真实帐号上的余额;
真实服务器,真正发送到手机上并扣除用户余额。
5、 操作成功的标志是什么?
状态:2000
信息:Command complateted successfully
即是操作成功的标志


   
时代互联 版权所有