### 移动代理服务器WebService接口协议详解
#### 一、概览
移动代理服务器（MAS，Mobile Agent Service）的WebService接口协议，旨在提供一种高效、安全的通信方式，以实现客户端与MAS之间的数据交换，主要服务于短信收发及状态报告等功能。此协议基于TCP短连接模式，MAS作为服务器端监听在特定端口上（默认7301），而客户端（client）则通过调用WebService接口来发起数据传输请求。
#### 二、API原理与功能概述
**1. API原理**
MAS产品的WebService API基于TCP协议进行数据传输，其具体工作流程及原理需参照《MAS移动代理服务器API 2.0开发手册》，本文档主要聚焦于WebService API的具体使用说明。
**2. 功能概述**
WebService接口API提供了以下主要功能：
- **MT短信发送**：允许客户端向指定的手机号码或号码集合发送短信。
- **MO短信接收**：使客户端能够接收来自特定手机号码的短信。
- **状态报告接口**：提供短信发送后的状态反馈机制，确保消息的可靠传递。
#### 三、WebService接口详细说明
**1. MASSMS WebService地址**
- **WSDL地址**：http://[MAS服务器IP]:8080/axis/services/SMsg?wsdl
- **服务地址**：http://[MAS服务器IP]:8080/axis/services/SMsg
这里的IP地址应替换为实际部署MAS服务器的IP地址。
**2. 接口方法**
#### (1) sendSM 方法
**功能**：用于发送一条MT短信至单个或多个手机号码。
**参数**：
- **apicode**：接口编码，必填项。
- **loginName**：接口创建时的登录用户名，必填项。
- **loginPwd**：接口创建时的登录密码，必填项。
- **mobiles**：目的手机号码，可输入多个，间以英文分号分隔，必填项。
- **content**：短信内容，长度限制为260字符以内，必填项。
- **smID**：短信ID，范围0至99999999的整数，用于标识短信以便追踪状态报告，可选参数，默认值为0。
#### (2) sendWAPPUSHSM 方法
**功能**：用于发送WAPPUSH类型短信至指定手机号码或集合。
**参数**：
- **apicode**、**loginName**、**loginPwd**、**mobiles**、**smID**：同sendSM方法。
- **title**：短信标题，必填项。
- **url**：WAPPush短信的URL，若为空或null则发送普通短信，长度限制为110字节，总长度（含标题和URL）不超过120字节，必填项。
**注意事项**：当URL超出长度限制时，MAS可能拒绝发送；总长度超限时，标题和内容将被截断。
#### 四、客户端调用方法
**1. Java开发示例**
客户端组件的调用示例使用Java语言编写，适用于Windows、Linux以及所有可安装JDK 1.3及以上版本和JCE（Java Cryptography Extension）的UNIX操作系统。该示例利用了Apache Axis项目库（版本1.1RC2）实现了SOAP over HTTP功能，详情可访问Apache Axis官网获取。
**2. SSL加密通信**
为了保障数据传输的安全性，客户端与MAS服务器之间的通信可通过SSL加密进行。具体实现需根据所使用的SOAP库及其对SSL的支持情况进行相应配置。
#### 结论
移动代理服务器的WebService接口协议为客户端提供了强大的短信收发及状态管理能力，通过标准的WebService调用，不仅简化了开发流程，还确保了通信的效率与安全性。开发者应遵循本文档所述的接口规范，合理设置参数，并结合具体的开发环境与需求，有效利用这一工具，提升应用的交互体验与服务质量。
