使用维泰短信网关可以轻松在你的软件或者网站中实现短信收发功能,提高系统的易用性,提供系统的使用价值。青岛维泰为你免费提供强大的技术支持,而你只要支付非常少的短信费用即可。二次开发接口包含VC,VB,PB,Delphi,C#,Java,ASP,PHP,JSP等等各种常用开发工具的源码。
维泰短信网关使用说明 (2006.11.01)
1. wtsmsOpen
long wtsmsOpen(char *lpServerURL, char * lpUserName, char * lpUserPass);
建立一个会话。
输入:
lpServerURL服务器的地址, 例如: http://www.waytide.com/cgi/sms81/
lpUserName 短信账号
lpUserPass 用户密码
返回一个会话句柄。返回0或者-1表示出错。
如果出错,可以调用wtsmsGetErrorText()返回详细的错误信息
2. wtsmsClose
long smsClose(long hSession);
关闭一个会话。
输入会话句柄。会话句柄是使用smsOpen返回的结果。
返回1表示关闭成功。-1表示关闭失败。
3. wtsmsSend
long smsSend(long hSession, char *lpMobile,char *lpText,unsigned long dwContext);
功能:
发送一条短信。
输入:
hSession 会话句柄,通过wtsmsOpen获取;
lpMobile 目标手机号码;小灵通号码要加区号;
lpText 短信内容, 最多不超过70字,向小灵通发送不超过60字;
dwContext 上下文标识,保留参数,可以为0。
返回:
如果成功,返回值大于0; 如果失败返回值小于0.
如果失败, 通过wtsmsGetErrorText可以获得更详细的信息.
4. wtsmsSendEx
long smsSend(long hSession, char *lpMobile,char *lpText,unsigned long dwContext);
功能:
发送多条短信。
输入:
hSession 会话句柄,通过wtsmsOpen获取;
lpMobile 目标手机号码;多个号码之间用分号分开;一次最多包含100个.
lpText 短信内容, 最多不超过70字,向小灵通发送不超过60字;
dwContext 上下文标识,保留参数,可以为0。
返回:
如果成功,返回值大于0; 如果失败返回值小于0.
如果失败, 通过wtsmsGetErrorText可以获得更详细的信息.
5. wtsmsQueryAccount
long wtsmsQueryAccount(long hSession);
查询账号余额
输入:
hSession 会话句柄,通过wtsmsOpen获取;
返回:
如果成功,返回值大于等于0表示剩余发送量;
如果失败返回值小于0.
如果失败, 通过wtsmsGetErrorText可以获得更详细的信息.
6. wtsmsSetRelay
long wtsmsSetRelay(long hSession, char * lpMobile);
设置转发短信的接收号码, 系统接收到短信后,可以自动转发到指定的号码上。
输入:
hSession 会话句柄,通过wtsmsOpen获取;
lpMobile 接收回复短信的手机号码,如果为空表示关闭自动转发功能。
返回:
如果成功,返回值大于等于0;
如果失败返回值小于0.
如果失败, 通过wtsmsGetErrorText可以获得更详细的信息。
7. wtsmsSetMyServer
long wtsmsSetMyServer(long hSession,char * lpServerURL);
设置用来接收短信的服务器地址
输入:
hSession 会话句柄,通过wtsmsOpen获取;
lpServerURL接收回复短信的服务器地址。例如:
http://www.yourserver.com/sms/getrecv.asp
返回:
如果成功,返回值大于等于0;
如果失败返回值小于0.
如果失败, 通过wtsmsGetErrorText可以获得更详细的信息。
说明:
你的服务器脚本必须接收以下参数:
id 短信编号,服务器端流水号
mobile 发送短信的手机号码
user 接收短信的用户账号
text 短信内容
smstime 接收短信的时间
维泰短信网关不支持轮训方式获取回复的上行短信。你只能通过以下方式获得上行短信:
× 设置转发,通过自己的手机接收短信。
× 设置接收服务器地址,通过自己的网站脚本接收短信。