移动代理服务器 MAS
短信 API2.2
开发手册
（JAVA）
V2.2
深圳市嘉讯软件有限公司
二○○七年十一月
移动代理服务器 MAS 短信 API2.2 开发手册(JAVA)
第 ii 页 共 36 页
目 录
1 引言.............................................................................................................................................1
1.1 编写目的.............................................................................................................................1
1.2 背景说明.............................................................................................................................1
1.3 术语定义.............................................................................................................................1
2 概述.............................................................................................................................................3
2.1 接口功能.............................................................................................................................3
2.2 接口组成.............................................................................................................................4
2.3 短信收发机制.....................................................................................................................4
2.3.1 MT 短信与其回执、回复的对应..............................................................................4
2.3.2 MO 短信的分流 .........................................................................................................5
3 接口介绍.....................................................................................................................................6
3.1 接口管理模块.....................................................................................................................6
3.1.1 主页面.........................................................................................................................6
3.1.2 新建页面.....................................................................................................................7
3.1.3 编辑页面.....................................................................................................................9
3.1.4 队列管理页面.............................................................................................................9
3.2 数据库 DB 接口 ...............................................................................................................10
3.2.1 发送队列表...............................................................................................................11
3.2.2 接收队列表...............................................................................................................13
3.2.3 回执队列表...............................................................................................................13
3.3 Java API............................................................................................................................13
3.3.1 类 APIClient.............................................................................................................14
3.3.2 类 MOItem................................................................................................................28
3.3.3 类 RPTItem...............................................................................................................29
4 使用指导...................................................................................................................................29
4.1 开发步骤...........................................................................................................................29
4.2 调试方法...........................................................................................................................30
4.3 运行设置与监控...............................................................................................................31
5 附录...........................................................................................................................................32
5.1 附录一：API 返回值列表 ...............................................................................................32
5.2 附录二：回执编码列表...................................................................................................33
移动代理服务器 MAS 短信 API2.2 开发手册(JAVA)
第 1 页 共 36 页
1 引言
1.1 编写目的
移动代理服务器 MAS 提供了强大的短信接入机制。本手册用于指导客户利用移动代
理服务器 MAS 提供的短信接口进行其他需要短信功能的新系统开发或原有系统的短信功
能扩展。
本手册的阅读对象为需要采用移动代理服务器 MAS 的短信接口完成客户开发的设计
人员与编码人员。
1.2 背景说明
本手册适用于产品“移动代理服务器 MAS” V1.1 + MAS1.1 P08D071121 通用补丁。
1.3 术语定义
移动代理服务器 MAS：
全称为“移动代理服务器 MAS”，属深圳嘉讯软件公司开发的一套
产品，本手册中有时也直接简称为“移动代理服务器”或“MAS”。
MT 短信：
通过短信接口发往手机终端的短信，也指从移动代理服务器的某
一功能直接发往手机终端的短信。
MO 短信：
从手机终端发往移动代理服务器的短信，这些短信根据特定的规
则有的直接转交到移动代理服务器的某一具体功能，有的转交到
某一短信接口的接收队列。
短信回执：
有时也称“状态报告”， 对 于 MT 短信，手机终端收到后会返回短
信回执给移动代理服务器。对于短信接口，在创建接口时，回执
选择为支持回执，则通过发送队列发送出去的所有 MT 短信随后都
会在回执队列中收到对应的回执。回执包含 MT 短信是否成功提交
到特定手机终端的信息。
移动代理服务器 MAS 短信 API2.2 开发手册(JAVA)
第 2 页 共 36 页
短信回复：
对于 MT 短信，手机终端收到后可以使用短信回复功能回复一条短
信，对于通过发送队列发送的 MT 短信，其回复短信随后都可以从
接收队列中获得。如果接口设置为支持短号，则不能直接回复接
口所发出的短信。
接口编码：
某套短信接口的唯一标识，在创建接口时设置，随后不允许修改。
短信子码：
也称“短信子号”， 每 套 短信接口都拥有一个特定数字，这个特 定
数字由短信收发机制所使用，其具体作用请参照章节 2.3.1
手机指令：
有时也称“命令字”或“指令”， 每 套 短信接口可以设置一个 手
机指令，由字母或数字组成的，用户可以使用此指令主动发送 MO
短信到 MAS，其作用请参照章节 2.3.2
移动代理服务器 MAS 短信 API2.2 开发手册(JAVA)
第 3 页 共 36 页
2 概述
移动代理服务器 MAS 不仅为各种类型的集团客户直接提供了丰富的短信业务应用功
能，而且提供强大的短信接入机制。
此机制允许客户再接入任何其他系统以开发此系统的短信应用功能，从而使拥有移
动代理服务器 MAS 的客户相当于拥有了一个属于自己的“袖珍型短信行业网关”
2.1 接口功能
移动代理服务器 MAS 的短信接入机制所提供的功能是很强大的：
n 支持 MT 短信的发送、MO 短信的接收。
n 所发送的 MT 短信可包括多达 2000 个汉字。
n 支持 MT 短信的回执确认。
n 支持 MT 短信的回复会话。
n 支持自定义 MT 短信在手机上显示的号码。
n 支持定时发送 MT 短信。
n 可提供多套短信接口，从而支持多套不同系统的接入。
n 支持通过分配给接口的短信子码来接收 MO 短信。
n 支持通过接口设置的手机指令来接收 MO 短信。
n 对通过接口发送的短信可以进行短信内容过滤。
n 对通过接口发送的短信可以进行黑白名单的控制。
n 所有接口的收发短信都有话单记录
n 可以出丰富的接口短信话单报表。
n 提供接入的多种语言开发包。
