移动代理服务器SOCKET API接口协议.pdf

### 移动代理服务器SOCKET API接口协议解析 #### 1. 概述 移动代理服务器（Mobile Agent Service，简称MAS）SOCKET API接口协议是深圳市嘉讯软件有限公司设计的一套用于MAS与客户端通过API方式通信的技术规范。该文档详细介绍了如何通过TCP协议实现MAS与客户端之间的数据交换，并特别关注了基于SOCKET API接口的数据传输流程。 #### 2. 缩略语解释 - **SAPP (SOKET API Peer to Peer)**：嘉讯SOCKET API接口点对点协议客户端。 - **Client**：指所有通过SOCKET API协议接入MAS的客户端。 - **MAS (Mobile Agent Service)**：移动代理服务器，负责处理来自客户端的请求并进行相应的业务逻辑处理。 #### 3. SOCKET API原理 SOCKET API接口的设计目的是为了实现MAS与客户端之间高效、稳定的数据传输。其中，客户端作为发起者，MAS作为服务端，两者之间的通信基于TCP协议实现。 #### 4. SAPP功能概述 SAPP协议提供了两类主要的业务操作： 1. **Client发送数据到MAS**：例如发送短信至MAS。 2. **Client从MAS接收数据**：如接收MAS发送过来的状态报告和MO短信。 #### 5. 通信方式 - **短连接**：通信双方采用短连接方式。这意味着，在有数据交互时建立TCP连接，数据发送完成后断开此连接，每次TCP连接仅完成一对SAPP消息的发送。 - **登录校验**：连接建立后，客户端需发送“连接请求”包到MAS进行身份校验。每个API仅支持单连接，不支持多连接。 - **校验响应**：如果校验成功，则用户可以执行发送消息、接收状态报告或MO短信等操作；如果校验失败，则发送失败响应包并主动断开连接。 - **发送消息**：客户端在收到登录成功的响应后，可以开始发送submit消息。如果需要发送的号码过多，则需要分多次上传。 - **MO与状态报告**：客户端建立连接后，可以接收MO信息和状态报告信息。如果没有在10秒内接收到任何消息，则断开连接，等待下一次请求。 - **拆除连接**：完成消息发送、MO接收、状态报告接收后，需主动断开连接。 - **端口号**：MAS监听端口为7301，客户端连接该端口。 #### 6. 消息定义 - **基本数据类型**：例如Unsigned Integer（无符号整数）等。 - **消息结构**：包括消息头（Message Header）和消息体（Message Body）两部分。 - **消息头格式**（Message Header）： - **Total_Length**：消息总长度（包含消息头和消息体）。 - **Command_Id**：命令或响应类型。 - **Sequence_Id**：消息流水号，用于追踪消息对。 - **Version**：协议版本号。 - **Reserved**：保留字段，用于未来扩展。 #### 7. 客户端与MAS间的消息定义 - **连接请求（CONNECT）**：客户端向MAS发起连接请求，通过身份验证后方可进行业务数据传输。 - **Command_Id**: CONNECT - **Sequence_Id**: 消息流水号，用于追踪消息对。 #### 8. 结论 深圳市嘉讯软件有限公司提供的移动代理服务器SOCKET API接口协议是一种高效的数据传输机制，它通过TCP短连接的方式实现了MAS与客户端之间的稳定通信。通过明确的消息定义和严格的通信流程，确保了数据传输的安全性和可靠性。对于希望集成MAS服务的企业而言，理解和遵循这一协议是非常重要的。