### MAS2.0 WebService接口插件开发手册关键知识点概览
#### 1. 引言
- **编写目的**：本手册旨在详细介绍MAS2.0基座WebService通信接口的使用方法，帮助MAS开发人员、数字化部队、SI工程技术人员、SI开发人员以及集团客户的技术人员更好地理解和使用该接口。要求读者具备一定的WebService相关知识。
- **相关术语与缩略语解释**：
- **MAS (Mobile Agent Server)**：移动代理服务器，是用于管理和控制移动通信能力的平台。
- **HTTP (Hypertext Transfer Protocol)**：超文本传输协议，是一种用于传输网页数据的应用层协议。
- **HTTPS (Secure HTTP)**：加密的HTTP协议，提供安全的数据传输。
- **SOAP (Simple Object Access Protocol)**：简单对象访问协议，是一种轻量级的协议，用于在Web服务中交换结构化的信息。
- **UCA (Unified Communication Agent)**：统一通信代理，提供统一的通信服务。
- **WS (WebService)**：Web服务接口，提供跨平台的服务调用能力。
#### 2. 概述
- **概述**：本手册涵盖了MAS2.0基座提供的WebService通信接口的功能和服务。这些接口统一封装了多种移动通信能力，并通过标准化的接口降低SI（System Integrator）的开发难度。接口支持的功能包括：
- 短信
- 彩信
- Wappush
- USSD（暂时不可用）
- LBS（暂时不可用）
#### 3. 二次开发环境
- **二次开发环境**：MAS2.0的二次开发主要依赖于以下几个环境：
- **MAS2.X运行环境**：指MAS2.0及其以上版本的运行环境。
- **MAS服务平台环境**：包括MAS服务器本身及相关支持服务。
- **WebService适配插件**：用于实现MAS服务器与外部系统的通信适配。
#### 4. 开发步骤
- **开发步骤**：MAS2.0 WebService接口的开发流程包括以下几个主要步骤：
- **4.1. 在MAS服务器新建一个企业应用**：在MAS平台上创建一个新的企业应用项目。
- **4.2. 启动企业应用**：确保新创建的企业应用能够正常启动并运行。
- **4.3. 访问并获取WebService方式通信适配插件服务地址**：通过MAS服务器提供的工具获取WebService接口的地址信息。
- **4.4. 客户端及服务端代码生成**：根据WebService接口文档生成客户端和服务端所需的代码框架。
- **4.5. 接口开发及使用举例**：提供详细的接口开发示例，包括短信接口、彩信接口和Wappush短信接口的具体实现方法。
- **短信接口**：
- 发送短信（sendSms操作）
- 获取短信发送状态（getSmsDeliveryStatus操作）
- 通知短信发送状态（notifySmsDeliveryStatus操作）
- 获取MO短信（getReceivedSms操作）
- 通知MO短信到达（notifySmsReception操作）
- **彩信接口**：
- 发送彩信（sendMessage操作）
- 获取彩信发送状态（getMessageDeliveryStatus操作）
- 通知彩信发送状态（notifyMessageDeliveryReceipt操作）
- 获取MO彩信摘要（getReceivedMessages操作）
- 获取MO彩信（getMessage操作）
- 通知MO彩信到达（notifyMessageReception操作）
- **Wappush短信接口**：
- 发送Wappush（sendPush操作）
- 获取Wappush发送状态（getPushDeliveryStatus操作）
- 通知Wappush发送状态（notifyPushDeliveryReceipt操作）
- **4.6. 常见错误及处理方式**：列举在开发过程中可能遇到的问题及其解决方法。
#### 5. 接口描述
- **接口描述**：本节详细描述了各个接口的功能、工作流程和所需的数据类型。
- **5.1. 短信接口**：包括接口的基本介绍、工作流程和涉及的数据类型。
- **5.2. 彩信接口**：同样包括接口介绍、工作流程和数据类型说明。
- **5.3. Wappush短信接口**：涵盖接口说明、流程说明和数据类型描述。
#### 6. 参考文档
- **参考文档**：提供了一些额外的学习资源，以便开发者进一步了解相关的技术和规范。
MAS2.0 WebService接口插件开发手册是一个非常全面且实用的指南，它不仅详细介绍了接口的使用方法，还提供了丰富的示例代码和错误处理策略，对于MAS2.0基座的开发人员来说具有很高的参考价值。
