MAS应用服务器webservice接口用户手册资料.doc

嘉讯软件
IM移动信息机 Web Service API接口用户手册
: .
MAS 服务器 Web Service API接口
用户手册

嘉讯软件
2006-3
#
IM移动信息机 Web Service API接口用户手册
■■乍嘉讯软件
■ ■■
修订记录
ID
修订历史
修改人
日期

陈铁钢
2006-4-1

高乐平
2006-12-12
#
■■乍嘉讯软件
IM移动信息机 Web Service API接口用户手册
#
嘉讯软件
IM移动信息机 Web Service API接口用户手册
移动信息机
,则表示 sm
1简介
本协议用于IM与 通过API接入IM的客户端的数据传输通讯。
缩略语清单：
client :所有通过 Web Service 接口接入 IM 的客户端
IM(Information Machine):信息机，本文中特指短信 API移动服务端
API原理
Web Service api短信收发使用原理请参照 IM产品发布时附带的文件《IM
》。本文档不再重复阐述。
本文档解决的是 Web Service API使用方式说明。
Web Service 接口 API 功能概述
1) MT短信发送；
2) MO短信接收;
3) 状态报告接口;
2 访问 sm webserviceH服务地址
WSDL : ?wsdl
地址：
注意：，实指用户IM机器的IP地址。
在IE中任意输入以上两个 url地址，如可以访问到服务(没有出现异常)
webservice服务已正常启动，可以进行以下开发
3 仓建 sm webservice 接口
在web页面中登陆信息机，进入系统管理一接口管理新增页面如下图
新增極口
接口編咼：
接口名称：
sm ^pi
此 接口类型：
「巩接口 c AH接口 金 ffEB SERVICE®口 r SOCKET
接口
短信子码：
h J
sm
回执要求：
「支持回执 金不支持回埶
登录用户：
$EHpi
登录密码：
jtrxkh
接口状态：
厂运行舷 a调试状蛊
短信回执目标
http ^/127 X) .:8O8O/test1. Jsp
trz 目标url :
http：：e080rte5l2 j印
〔保存丨［砥回|
1. 选择接口类型为 web service 接口
2. 如果不需要回执回执要求一项选择为不支持回执
3. 短信回执目标url —项为客户端被动接收回执的 URL，根据用户自己需要填写
4. mo目标url —项为客户端被动接收 MO的URL，根据用户自己需要填写接口说明
5. 如果不需要回执和 mo，短信回执目标url和mo目标url可填空
6. 接口状态选运行状态，否则短信无法发送成功
7. 其他几项用户根据自己需要填写
4 Web Service接口方法说明
sendSM 方法
方法说明：发送一条MT短信到一个手机号码/手机号码集。
public String sen dSM(Stri ng apicode,
Stri ng logi nN ame,
Stri ng logi nPwd,
String mobiles,
String content,
Stri ng smID
)
参数说明：
参数
描述
apicode
接口编码（必填）
logi nN ame
接口创建时的接口登录名（必填）
logi nPwd
接口创建时的接口登录密码 （必填）
mobiles
短信发送的目的手机号码。可以填写多个，但必须以
英文分号隔开（必填）如如：“**********,********** ” （必填）
Content
短信内容，超过260个字符部分会被截断（必填）
smID
短信ID，0到99999999中的某一整数。确保唯一后可 以用来找到对应的回执、回复。缺省值 0。（可为空）
sendWAPPUSHS