MAS应用服务器webservice接口用户手册.docVIP

MAS效劳器WebServiceAPI接口

用户手册

嘉讯软件

2006-3

修订记录

ID

修订历史

修改人

日期

陈铁钢

2006-4-1

高乐平

2006-12-12

简介

本协议用于IM与通过API接入IM的客户端的数据传输通讯。

缩略语清单：

client：所有通过WebService接口接入IM的客户端

IM(InformationMachine)：信息机,本文中特指短信API移动效劳端

API原理

WebServiceapi短信收发使用原理请参照IM产品发布时附带的文件《IM移动信息机API2.0开发手册》。本文档不再重复阐述。

本文档解决的是WebServiceAPI使用方式说明。

WebService接口API功能概述

MT短信发送；

MO短信接收；

状态报告接口；

访问smwebservice效劳地址

WSDL：:///axis/services/SMsg?wsdl

地址：/axis/services/SMsg

注意：这里127.0.0.1只是例如，实指用户IM机器的IP地址。

在IE中任意输入以上两个url地址，如可以访问到效劳〔没有出现异常〕，那么表示smwebservice效劳已正常启动，可以进行以下开发

创立smwebservice接口

在web页面中登陆信息机，进入系统管理—接口管理新增页面如以下图

选择接口类型为webservice接口

如果不需要回执回执要求一项选择为不支持回执

短信回执目标url一项为客户端被动接收回执的URL，根据用户自己需要填写

mo目标url一项为客户端被动接收MO的URL，根据用户自己需要填写接口说明

如果不需要回执和mo，短信回执目标url和mo目标url可填空

接口状态选运行状态，否那么短信无法发送成功

其他几项用户根据自己需要填写

WebService接口方法说明

sendSM方法

方法说明：发送一条MT短信到一个号码/号码集。

publicStringsendSM(Stringapicode,

StringloginName,

StringloginPwd,

Stringmobiles,

Stringcontent,

StringsmID

)

参数说明：

参数

描述

apicode

接口编码(必填)

loginName

接口创立时的接口登录名(必填)

loginPwd

接口创立时的接口登录密码(必填)

mobiles

短信发送的目的号码。可以填写多个，但必须以英文分号隔开(必填)如：“”(必填)

Content

短信内容，超过260个字符局部会被截断(必填)

smID

短信ID，0的某一整数。确保唯一后可以用来找到对应的回执、回复。缺省值0。〔可为空〕

sendWAPPUSHSM方法

方法说明：发送一条MTWAPPUSH短信到一个号码/号码集。

publicStringsendSM(Stringapicode,

StringloginName,

StringloginPwd,

Stringmobiles,

Stringtitle,

Stringurl,

StringsmID

)

参数说明：

参数

描述

apicode

接口编码(必填)

loginName

接口创立时的接口登录名(必填)

loginPwd

接口创立时的接口登录密码(必填)

mobiles

短信发送的目的号码。可以填写多个，但必须以英文分号隔开(必填)如：“”(必填)

title

短信标题。

url

WAPPush短信的URL，为“”或null时那么发送常规短信。(必填)

smID

短信ID，0的某一整数。确保唯一后可以用来找到对应的回执、回复。缺省值0。〔可为空〕

sendSM方法

方法说明：发送一条MT短信到一个号码/号码集。

publicStringsendSM(Stringapicode,

StringloginName,

StringloginPwd,

Stringmobiles,

Stringcontent,

longsmID

)

参数说明：

参数

描述

apicode

接口编码(必填)

loginName

接口创立时的接口登录名(必填)

loginPwd

接口创立时的接口登录密码(必填)

mobiles

短信发送的目的号码。可以填写多个，但必须以英文分号隔开(必填)如：“”(必填)

Content

短信内容，超过260个字符局部会被截断(必填)

smID

短信ID，0的某一整数。确保唯一后可以用来找到对