中国移动通信互联网短信网关接口协议.docx

中国移动通信互联网短信网关接口协议.docx

《中国移动通信互联网短信网关接口协议.docx》由会员分享，可在线阅读，更多相关《中国移动通信互联网短信网关接口协议.docx（46页珍藏版）》请在冰豆网上搜索。

中国移动通信互联网短信网关接口协议

中国移动通信互联网短信网关接口协议

（ChinaMobile,）

（）

中国移动网关程序下载地址：

电话：

中国移动通信集团公司

年月

前言

．范围

．缩略语

．网络结构

．功能概述

.协议栈

.通信方式

长连接

短连接

本协议中涉及的端口号

交互过程中的应答方式

．消息定义

基本数据类型

消息结构

消息头格式（）

信息资源站实体（）与互联网短信网关（）间的消息定义

请求连接到（）操作

消息定义（→）

消息定义（→）

或请求拆除连接（）操作

消息定义（→或→）

消息定义（→或→）

向提交短信（）操作

消息定义（→）

消息定义（→）

向查询发送短信状态（）操作

消息的定义（→）

消息的定义（→）

向送交短信（）操作

消息定义（→）

消息定义（→）

向发起删除短信（）操作

消息定义（→）

消息定义（→）

链路检测（）操作

定义（→或→）

定义（→或→）

互联网短信网关（）之间的消息定义

源请求连接到目的（）操作

源请求拆除到目的的连接（）操作

链路检测（）操作

源向目的转发短信（）操作

定义（→）

定义（→）

互联网短信网关（）与汇接网关（）之间的消息定义

请求连接到或请求连接到（）操作

请求拆除到的连接或请求拆除到的连接（）操作

向汇接网关查询路由（）操作

消息定义（→）

消息定义（→）

向汇接网关查询路由（）操作

消息定义（→）

消息定义（→）

向汇接网关获取路由（）操作

消息定义（→）

消息定义（→）

向汇接网关更新路由（）操作

消息定义（→）

消息定义（→）

向汇接网关更新路由（）操作

消息定义（→）

消息定义（→）

汇接网关向更新路由（）操作

消息定义（→）

消息定义（→）

汇接网关向更新路由（）操作

消息定义（→）

消息定义（→）

系统定义

定义

附录状态报告的产生

修订历史

前言

本规范为中国移动通信集团公司企业规范，简称，现阶段版本是对1.2.1版修订后形成的，为版。

本规范描述了中国移动短信业务中各网元（包括、和）之间的相关消息的类型和定义。

根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。

本规范解释权属于中国移动通信集团公司。

本规范起草单位：

中国移动通信集团公司研发中心。

1．范围

本规范规定了以下三方面的内容：

（1）信息资源站实体与互联网短信网关之间的接口协议；

（2）互联网短信网关之间的接口协议；

（3）互联网短信网关与汇接网关之间的接口协议。

本规范适用于各和的开发厂商。

2．缩略语

英文缩写

英文全称

说明

互联网短信网关

短消息点对点协议

ChinaMobile

中国移动点对点协议

ShortMessageCenter

短消息中心

网关名称服务器（汇接网关）

业务提供者，即信息资源站实体

为收取包月业务费用而向网关发送的消息，网关收到后不送给用户仅产生相应的话单；

网关代码：

，其中为省会区号，位数不足时左补零，如北京编号为的网关代码为，江西编号为的网关代码为，依此类推。

的企业代码：

网络中地址和身份的标识、地址翻译、计费、结算等均以企业代码为依据。

企业代码以数字表示，共位，从“000”至“999”，其中“”为各移动公司代码。

的服务代码：

服务代码是在使用短信方式的点播类业务中，提供给用户点播的内容应用服务提供商代码。

服务代码以数字表示，全国业务服务代码长度统一为位，即“1000”－“9999”；本地业务服务代码长度统一为位，即“01000”－“09999”。

的业务类型，数字、字母和符号的组合，由自定，如图片传情可定为，股票查询可定义为。

．网络结构

如图所示，互联网短信网关（）是外部信息资源站实体（）与移动网内短信中心之间的中介实体，互联网短信网关一方面负责接收发送给移动用户的信息和提交给短信中心。

另一方面，移动用户点播业务的信息将由短信中心通过互联网短信网关发给。

另外，为了减轻短信中心的信令负荷，互联网短信网关还应根据路由原则将提交的信息转发到相应的互联网短信网关。

互联网短信网关通过向汇接网关（）查询的方式获得网关间的转发路由信息。

．功能概述

协议主要提供以下两类业务操作：

（1）短信发送（，）

典型的业务操作举例如图所示：

图需要前转的示意图

1）手机发出数据请求（可能是订阅信息或图片点播等），被源接收；

2）源对接收到的信息返回响应；

3）源在本地查询不到要连接的，向（汇接网关）发路由请求信息；

4）将路由信息返回；

5）源根据路由信息将请求前转给目的；

6）目的对接收到的信息返回响应；

7）目的将请求信息送

8）返回响应；

在以上操作中，步骤到步骤均使用协议；

在随后的操作中，目的在接收到的响应后将产生状态报告发给源。

（2）短信接收（，）

典型的业务操作举例如图所示：

图需要前转的示意图

1）发出数据请求（可能是短信通知或手机铃声等），被源接收；

2）源对接收到的信息返回响应；

3）源在本地数据库中找不到要目的手机号段所对应网关代码，向（汇接网关）发路由请求信息；

4）汇接网关将路由信息返回；

5）源根据路由信息将请求前转给目的；

6）目的对接收到的信息返回响应；

7）目的将请求信息发送至；

8）向目的返回响应；

在上述操作中，步骤到步骤均使用协议；

在随后的操作中，将通过信令网向移动用户发送信息，移动用户收到后将返回状态报告（）给短信中心，短信中心将按照操作的流程将状态报告返回给（如果要求返回状态报告）。

.协议栈

协议以作为底层通信承载，具体结构由图所示：

图协议栈

.通信方式

与之间、之间进行信息交互时，可以采用长连接方式，也可以采用短连接方式。

所谓长连接，指在一个连接上可以连续发送多个数据包，在连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。

短连接是指通信双方有数据交互时，就建立一个连接，数据发送完成后，则断开此连接，即每次连接只完成一对消息的发送。

.1长连接

通信双方以客户服务器方式建立连接，用于双方信息的相互提交。

当信道上没有数据传输时，通信双方应每隔时间发送链路检测包以维持此连接，当链路检测包发出超过时间后未收到响应，应立即再发送链路检测包，再连续发送次后仍未得到响应则断开此连接。

参数、、原则上应可配置，现阶段建议取值为：

分钟，秒，。

网关与之间、网关之间的消息发送后等待秒后未收到响应，应立即重发，再连续发送次后仍未得到响应则停发。

现阶段建议取值为：

秒，。

消息采用并发方式发送，加以滑动窗口流量控制，窗口大小参数可配置，现阶段建

议为，即接收方在应答前一次收到的消息最多不超过条。

长连接的操作流程举例如图所示：

图长连接一次操作流程

.2短连接

通信双方以客户服务器方式建立连接，应答与请求在同一个连接中完成。

系统采用客户服务器模式，操作以客户端驱动方式发起连接请求，完成一次操作后关闭此连接。

网关与之间、网关之间的消息发送后等待秒后未收到响应，应立即重发，再连续发送次后仍未得到响应则停发。

现阶段建议取值为：

秒，。

短连接的操作流程举例如图所示：

图短连接的操作流程

6.3本协议中涉及的端口号

端口号

应用

长连接（与网关间）

短连接（与网关间或网关之间）

长连接（网关之间）

短连接（短信网关与汇接网关之间）

交互过程中的应答方式

在与之间、与之间及之间的交互过程中均采用异步方式，即任一个网元在收到请求消息后应立即回送响应消息。

举例如图所示：

图异步交互方式示意图

．消息定义

基本数据类型

无符号整数

整数，可为正整数、负整数或零

定长字符串，位数不足时，如果左补则补表示的零，如果右补则补二进制的零

消息结构

项目

说明

消息头（所有消息公共包头）

消息体

消息头格式（）

字段名

字节数

类型

描述

消息总长度（含消息头及消息体）

命令或响应类型

消息流水号,顺序累加,步长为,循环使用（一对请求和应答消息的流水号必须相同）

信息资源站实体（）与互联网短信网关（）间的消息定义

与之间互为客户服务器，但要求首先以客户的身份请求连接到，之后与之间方可进行数据传输。

7.4.1请求连接到（）操作

操作的目的是向注册作为一个合法身份，若注册成功后即建立了应用层的连接，此后可以通过此接收和发送短信。

以消息响应的请求。

7.4.1消息定义（→）

字段名

字节数

属性

描述

源地址，此处为，即的企业代码。

用于鉴别源地址。

其值通过单向计算得出，表示如下：

（字节的）

由中国移动与源地址实体事先商定，格式为：

，即月日时分秒，位。

双方协商的版本号（高位表示主版本号,低位表示次版本号）

时间戳的明文,由客户端产生,格式为，即月日时分秒，位数字的整型，右对齐。

7.4.1消息定义（→）

字段名

字节数

属性

描述

状态

：

正确

：

消息结构错

：

非法源地址

：

认证错

：

版本太高

：

其他错误

认证码，用于鉴别。

其值通过单向计算得出，表示如下：

（），由中国移动与源地址实体事先商定，为源地址实体发送给的对应消息中的值。

认证出错时，此项为空。

服务器支持的最高版本号

.2或请求拆除连接（）操作

操作的目的是或基于某些原因决定拆除当前的应用层连接而发起的操作。

此操作完成后与之间的应用层连接被释放，此后若再要与通信时应发起操作。

或以消息响应请求。

7.4.2消息定义（→或→）

无消息体。

7.4.2消息定义（→或→）

无消息体。

7.4.3向提交短信（）操作

操作的目的是在与建立应用层连接后向提交短信。

以消息响应。

.3消息定义（→）

字段名

字节数

属性

描述

信息标识，由侧短信网关本身产生，本处填空。

相同的信息总条数，从开始

相同的信息序号，从开始

是否要求返回状态确认报告：

：

不需要

：

需要

：

产生话单

（该类型短信仅供网关计费使用，不发送给目的终端）

信息级别

业务类型，是数字、字母和符号的组合。

计费用户类型字段

：

对目的终端计费；

：

对源终端计费；

：

对计费;

：

表示本字段无效，对谁计费参见字段。

被计费用户的号码（如本字节填空，则表示本字段无效，对谁计费参见字段，本字段与字段互斥）

协议类型。

详细是解释请参考中的9.2.3

协议类型。

详细是解释请参考中的9.2.3,仅使用位，右对齐

信息格式

：

串

：

短信写卡操作

：

二进制信息

：

编码

：

含汉字。

。

。

。

。

。

信息内容来源（）

资费类别

：

对“计费用户号码”免费

：

对“计费用户号码”按条计信息费

：

对“计费用户号码”按包月收取信息费

：

对“计费用户号码”的信息费封顶

：

对“计费用户号码”的收费是由实现

资费代码（以分为单位）

存活有效期，格式遵