《亿美短信平台SDK4.2.0(WebService版)用户手册》由会员分享，可在线阅读，更多相关《亿美短信平台SDK4.2.0(WebService版)用户手册（16页珍藏版）》请在金锄头文库上搜索。
1、1/16 页 案卷号日期亿美软通短信平台 SDK4.2.0（WebService 版）用 户 手 册作 者： 北京亿美软件科技有限公司 完成日期： 2010-08-16 签 收 人： 签收日期： 修改情况记录：版本号 修改批准人 修改人 安装日期 签收人北京亿美软通科技有限公司地址： 北京市朝阳区光华路 4 号东方梅地亚中心 C 座 20 层（100026）网址： 手机快捷网址：电话：010-58750575 传真：010-58750500售前咨询：400-810-7255 售后服务：400-779-7255手机中文实名：亿美软通 亿美 移动商务2/16 页 目录用 户 手 册.11 亿美软通
2、 WEBSERVICE 接口开发说明 .31.1 简介 .31.2 背景 .31.3 定义 .31.4 开发流程 .42 数据结构 .52.1 上行数据结构 .52.2 状态报告数据结构 .53 功能介绍及使用 .53.1 注册序列号 .53.2 注册企业信息 .63.3 注销序列号 .73.4 查询单价 .83.5 序列号充值 .83.6 发送短信 .83.7 接收短信 .93.8 修改密码 .103.9 查询余额 .113.10 状态报告.123/16 页 1 亿美软通 WebService 接口开发说明1.1 简介亿美短信 SDK：是针对独立软件开发商（ISV）和系统集成商（SI）的软件
3、开发及技术产品服务的需求，提供的短信通讯开发组件（SDK，Software Development Kit)1.2 背景系统名称：亿美 SDK 移动商务开发组件项目开发者： 北京亿美软通科技有限公司1.3 定义MT Message Terminal下行短信，即向手机终端发送短信MO Message Original上行短信，即手机用户向特服号码发送短信企业特服号码 由亿美为 SDK 用户分配的属于该用户专用的特服号码。每个 软件序列号对应一个企业特服号码。扩展号码 基于企业特服号码，企业自行扩展维护的子号码（最大 15 位） ，类似电话分机号码。软件序列号 由亿美分配给 SDK 用户，用来身份
4、验证、计费的标识信息EUCP Emay Unified Communication Platform亿美统一通讯平台EUCP 实现了统一的接入，提供统一的服务多运营商（中国移动、中国联通、中国网通、中国电信）的统一接入及服务提供，只需通过一个 SDK 接入 EUCP 即可统一的与上述运营商的手机用户进行短信通讯4/16 页 余额 与 SDK 帐户即软件序列号对应的帐户余额，只有拥有足够的余额才能进行成功的短信收发操作KEY 值 默认情况下，注册序列号后，序列号会与电脑的硬件信息绑定，这样一个序列号只能在一台定机器上使用。如果设置 Key 值，注册序列号后，序列号不会与电脑的硬件信息绑定，这样，
5、一个序列号就可以在多台机器上使用（不同的电脑上设置相同的 Key 值即可） 。优先级 发送短信时，可以定义短信的优先级别，重要的短信定义的优先级可以高一些，普通短信 可以使用低一点的优先级。可以定义 1-5 共 5 个级别的优先级，其中 1 为最低优先级，5 为最高优先级1.4 开发流程合作伙伴必须通过亿美软通或是亿美软通代理商，取得 SDK 开发包和相关文档，取得供由本 SDK 使用的序列号及密码，这些参数将用于服务注册及短信发送。接口调用流程如下： 永久执行 序列号首次使用时执行一次，就像我们的信用卡一样，首次使用必须激活一次 调用软件序列号注销以后，再次使用该序列号时必须重新激活 运行时
6、执行 主要是发送短信接口，软件序列号激活以后便可以随时使用我们的短信发送接口，前提是软件序列号处于激活状态 需要时执行5/16 页 需要时执行的方法，调用频率相对较低，我们可以在需要的时候调用一次啊，前提是软件序列号处于激活状态 结束执行 此接口一旦调用该软件序列号便不能在使用，即不能发送短信等，直到下次重新激活2 数据结构2.1 上行数据结构 所属类：MO 用途 保存上行短信接口函数返回的短信内容。字段名 数据类型 说明mobileNumber String 手机号码smsContent String 内容sentTime Sting 发送时间（格式为 yyyy-mm-dd hi24:mi:
7、ss）addSerial Sting 发送者扩展号码（只有当发送者申请扩展号码功能后，该参数才有效）addSerialRev Sting 接收者扩展号码（只有当接收者申请扩展号码功能后，该参数才有效）channelNumber String 该字段用来接收上行短信的被叫号码2.2 状态报告数据结构 所属类：StatusReport 用途 保存状态报告接口函数返回的短信内容。字段名 数据类型说明reportStatus String 状态报告的值（0 发送成功）mobile String 手机号码submitDate Sting 发送时间（格式为 yyyy-mm-dd hi24:mi:ss）receiveDate Sting 接收时间（格式为 yyyy-mm-dd hi24:mi:ss）errorCode Sting 未发送成功错误编码Memo Sting 备注6/16 页 serviceCodeAdd Sting 短信下行时服务号码seqID Long 自定义唯一的消息 ID，长度 6 位，消息流水号,顺序累加,步长为 1,循环使用3 功能介绍及使用 3.1 注册序列号 功能介绍完成对序列号的注册。 序列号说明(1
