移动代理服务器mas短信socketapi接口协议

《移动代理服务器mas短信socketapi接口协议》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、Mas移动信息机SOCKETAPI协议1.0开发手册移动代理服务器MAS短信SOCKETAPI接口协议V1.0嘉讯软件13Mas移动信息机SOCKETAPI协议1.0开发手册2006-3修订记录ID修订历史修改人日期初稿V1.0陈铁钢2006-3-30初稿V2.0陶永江2007-12-14初稿V2.1陈宏海2008-9-2713Mas移动信息机SOCKETAPI协议1.0开发手册1简介本协议用于MAS与通过API接入MAS的客户端的数据传输通讯。两者的数据传输通讯采用TCP协议、短连接方式，MAS为服务器方，TCP监听端口为7301。缩略

2、语清单：SAPP(SOKETAPIPeertoPeer)：嘉讯socketapi接口点对点协议client：所有通过socketapi协议接入MAS的客户端MAS(InformationMachine)：信息机1.1API原理Socketapi短信收发使用原理请参照MAS产品发布时附带的文件〈MAS移动信息机API2.0开发手册〉。本文档不再重复阐述。本文档解决的是如何通过TCP连接方式使用socketapi。1.2SAPP功能概述本协议主要提供以下两类业务操作：（1）client发送数据到MAS典型的业务操作为发送短信到MAS（2）cl

3、ient从MAS接收数据典型的业务操作为接收MAS发送过来的状态报告和MO短信2通信方式2.1短连接通信交互采用短连接方式。短连接是指通信双方有数据交互时，就建立一个TCP连接，数据发送完成后，则断开此TCP连接，即每次TCP连接只完成一对SAPP消息的发送。通信双方以客户-服务器方式建立TCP13Mas移动信息机SOCKETAPI协议1.0开发手册连接，应答与请求在同一个连接中完成。系统采用客户/服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。client与MAS之间消息发送后等待T秒后未收到响应，应立即重发，再

4、连续发送N-1次后仍未得到响应则停发。现阶段建议取值为：T=60秒，N=3。短连接的操作流程举例如图6所示：......对SAPP消息1的响应SAPP消息1建立TCP连接拆除TCP连接服务器/客户端客户端/服务器端建立TCP连接SAPP消息2对SAPP消息2的响应拆除TCP连接图1短连接的操作流程过程如下：13Mas移动信息机SOCKETAPI协议1.0开发手册建立连接：建立连接过程由客户端发起。如果建立连接失败，重复发起连接，每次间隔30秒。登录校验：连接建立成功后，client发送“连接请求”包到MAS进行身份校验。注意，每个API只

5、支持单连接，不支持多连接。校验响应：如果验证成功，用户可以进行发送消息、接收状态报告、或者MO的操作。如果校验失败，则发送失败响应包后主动断开连接，client收到失败响应包后也随之断开连接。如果校验成功，则发送成功响应包。发送消息：在client收到Mas登录成功响应包后，client就开始发送submit消息。要求每包号码记录不超过100个，如果需要发送的号码过多，则进行多次上传。MO：建立连接后，可接收MO信息，如果等待10秒能未有消息获得，断开连接，等待下次继续请求获取。状态报告：建立连接后，可接收状态报告信息，如果等待10秒能未

6、有消息获得，断开连接，等待下次继续请求获取。请求拆除连接：发送消息、MO接收、状态报告接收完成后，要求主动断开连接。1.1本协议中涉及的端口号端口号应用7301MAS侦听端口，client连接该端口2消息定义2.1基本数据类型UnsignedInteger无符号整数13Mas移动信息机SOCKETAPI协议1.0开发手册1.1消息结构项目说明MessageHeader消息头(所有消息公共包头)MessageBody消息体1.2消息头格式（MessageHeader）字段名字节数类型描述Total_Length4UnsignedIntege

7、r消息总长度(含消息头及消息体)Command_Id4UnsignedInteger命令或响应类型Sequence_Id4UnsignedInteger消息流水号,顺序累加,步长为1,循环使用（一对请求和应答消息的流水号必须相同）Version1UnsignedInteger协议版本，目前版本填1Reserved1UnsignedInteger保留字段，方便以后扩充，比如是否采用压缩加密等1.3client与MAS间的消息定义client向作为服务器端的MAS发起连接请求，只有在通过身份验证之后通过client才能与MAS之间进行业务数据

8、传输。每个请求都有一个相应的应答返回。3.4.1连接请求（CONNECT）客户端与服务器端建立连接3.4.1.1CONNECT(clientàMAS)Command_Id:CONNECT