案卷号 日期
亿美软通短信平台SDK4.2.0（JAVA版）
用 户 手 册
作 者： 北京亿美软件科技有限公司 完成日期： 2010-12-13 签 收 人： 签收日期：
修改情况记录：
版本号 修改批准人 修改人 安装日期 签收人
北京亿美软通科技有限公司
地址： 北京市朝阳区光华路4号东方梅地亚中心C座20层（100026） 网址：www.emay.cn 手机快捷网址：emay.m.cn 电话：010-58750575 传真：010-58750500 售前咨询：400-810-7255 售后服务：400-779-7255 手机中文实名：亿美软通 亿美 移动商务
页1/30
目录
用 户 手 册 .................................................................................................................................................... 1 1
亿美软通SDK开发说明 ............................................................................................................................. 3 1.1 1.2 1.3
简介 ....................................................................................................................................................... 3 背景 ....................................................................................................................................................... 3 定义 ....................................................................................................................................................... 3
1.3.1 2
接口调用流程 ............................................................................................................................... 5
数据结构说明 ................................................................................................................................................ 6 2.1 2.2
上行数据结构 ....................................................................................................................................... 6 状态报告数据结构 ............................................................................................................................... 6
3 功能介绍及使用 ............................................................................................................................................ 7 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19
实例化客户端 ....................................................................................................................................... 7 注册序列号 ........................................................................................................................................... 7 注册企业信息 ....................................................................................................................................... 8 注销序列号 ......................................................................................................................................... 10 查询单价 ............................................................................................................................................. 10 查询余额 ............................................................................................................................................. 11 序列号充值 ......................................................................................................................................... 12 发送即时短信 ..................................................................................................................................... 13 发送即时短信（带扩展号）.............................................................................................................. 14 发送即时短信（带字符编码） .......................................................................................................... 15 发送即时短信（带扩展号和字符编码） .......................................................................................... 16 发送即时短信（带扩展号，字符编码和短信ID） ......................................................................... 17 发送定时短信 ..................................................................................................................................... 19 发送定时短信（带字符编码） .......................................................................................................... 20 发送定时短信（带扩展号）.............................................................................................................. 21 发送定时短信（带扩展号和字符编码） .......................................................................................... 22 接收短信 ............................................................................................................................................. 24 接收状态报告 ..................................................................................................................................... 24 修改密码 ............................................................................................................................................. 25
4 配置及环境要求 .......................................................................................................................................... 26 4.1 4.2 4.3 4.4
配置日志信息 ..................................................................................................................................... 26 查看日志 ............................................................................................................................................. 26 客户端配置 ......................................................................................................................................... 27 JAVA环境要求 ..................................................................................................................................... 28
2/30 页
5 开发建议...................................................................................................................................................... 28 5.1 5.2 5.3 5.4
准备工作 ............................................................................................................................................. 28 网络测试 ............................................................................................................................................. 28 开发建议 ............................................................................................................................................. 28 项目检查 ............................................................................................................................................. 28
6 常见问题解答 .............................................................................................................................................. 29 6.1 6.2 6.3 6.4 6.5 6.6 6.7
系统找不到指定的路径 ..................................................................................................................... 29 关于序列号优先级 ............................................................................................................................. 29 关于短信优先级 ................................................................................................................................. 29 余额不足时短信发送 ......................................................................................................................... 29 客户网络环境条件 ............................................................................................................................. 29 异常处理 ............................................................................................................................................. 30 无法连接到服务器 ............................................................................................................................. 30
1
1.1
亿美软通SDK开发说明
简介
亿美短信SDK：是针对独立软件开发商（ISV）和系统集成商（SI）的软件开发 及技术产品服务的需求，提供的短信通讯开发组件（SDK，Software Development Kit)
1.2
背景
系统名称：亿美SDK移动商务开发组件 项目开发者： 北京亿美软通科技有限公司
1.3
定义
MT Message Terminal——下行短信，即向手机终端发送短信 MO Message Original——上行短信，即手机用户向特服号码发送短信
企业特服号码 由亿美为SDK用户分配的属于该用户专用的特服号码。每个
3/30 页
软件序列号对应一个企业特服号码。
扩展号码 基于企业特服号码，企业自行扩展维护的子号码（最大15位），类似电话分机号码。 软件序列号 由亿美分配给SDK用户，用来身份验证、计费的标识信息 EUCP Emay Unified Communication Platform——亿美统一通讯平台
EUCP实现了统一的接入，提供统一的服务
多运营商（中国移动、中国联通、中国网通、中国电信）的统一接入及服务提供，只需通过一个SDK接入EUCP即可统一的与上述运营商的手机用户进行短信通讯
余额 与SDK帐户即软件序列号对应的帐户余额，只有拥有足够的余额才能进行成功的短信收发操作
KEY值 默认情况下，注册序列号后，序列号会与电脑的硬件信息绑定，这样一个序列号只 能在一台定机器上使用。如果设置Key值，注册序列号后，序列号不会与电脑的硬件信息绑定 ，这样，一个序列号就可以在多台机器上使用（不同的电脑上设置相同的Key值即可）。
优先级 发送短信时，可以定义短信的优先级别，重要的短信定义的优先级可以高一些，普通短信 可以使用低一点的优先级。可以定义1-5 共5个级别的优先级，其中1为最低优先级，5为最高优先级
4/30 页