上海移动通信企业短信通平台接口协议

上海移动通信
企业短信通平台接口协议
Enterprise Message Point to Point, EMPP
（v 2.0）
上海移动通信有限公司
2004 年6 月
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
上海移动通信企业短信通平台接口协议
目录
第1 章协议概述............................................................................................................................2
1.1. 范围........................................................................................................................................2
1.2. 引用标准................................................................................................................................2
1.3. 术语和定义............................................................................................................................2
1.4. EMPP功能概述.....................................................................................................................3
1.5. 协议栈....................................................................................................................................3
1.6. 通信方式................................................................................................................................3
1.6.1. TCP连接........................................................................................................................3
1.6.2. 本协议涉及的端口号....................................................................................................4
1.6.3. 交互过程中的应答方式................................................................................................4
第2 章消息定义............................................................................................................................5
2.1. 基本数据类型.........................................................................................................................5
2.2. 消息结构................................................................................................................................5
2.3. 消息头格式（MESSAGE HEADER）.....................................................................................5
2.4. COMMNADID定义..................................................................................................................5
2.5. EP请求连接到ESMP（EMPP_CONNECT）操作...........................................................6
2.6. EP或ESMP请求拆除连接（EMPP_TERMINATE）操作...............................................8
2.7. EP向ESMP提交短信（EMPP_SUBMIT）操作................................................................9
2.8. ESMP向EP送交短信（EMPP_DELIVER）操作...........................................................12
2.9. 链路检测（EMPP_ACTIVE_TEST）操作......................................................................16
2.10. EP 向ESMP 请求查询回复英斯克的短信......................................................................16
2.11. EP 向ESMP请求更新通讯录.............................................................................................17
2.12. EP 向ESMP请求更改密码.................................................................................................18
2.13. EP 向ESMP 发送提交企业疑问请求..............................................................................18
2.14. ESMP 向EP 发送企业疑问解答. .....................................................................................19
2.15. EP 向ESMP 请求运营商发布的信息..............................................................................20
2.16. EP 向ESMP 发送双重认证短信.....................................................................................21
2.17. ESMP 向EP 发送未授权响应..........................................................................................23
2.18. EP 向ESMP 请求查询短信状态......................................................................................23
第3 章群发短信的实现..............................................................................................................24
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
上海移动通信企业短信通平台接口协议
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 1 of 15
前言
本规范规定了上海移动企业短信通业务客户接入的消息类型和定义，目前为
2.0.0 版本，是在原来1.0.0 版本的基础上进行修订而成。根据业务的发展，规
范中的信令操作和参数将会做进一步的调整和增加。
本标准由上海移动通信有限责任公司数据业务中心提出并归口。
本标准起草单位：上海移动通信有限责任公司数据业务中心。
本标准主要起草人：杨昕骅。
本标准解释单位：同提出单位。
上海移动通信企业短信通平台接口协议
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 2 of 15
第1 章协议概述
1.1. 范围
本规范规定了EP 与ESMP 之间短信收发接口协议的内容：
本规范适用于各EP 的开发厂商。
1.2. 引用标准
下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。本标准
出版时，所示版本均为有效。所有标准都会被修订。
1.3. 术语和定义
缩写全称说明
ESMP Enterprise Short Message
Platform
企业短信平台
SMSC 短信中心
EMPP Enterprise Message Point
to Point
企业短信平台点对点协议
ISMG Internet Short Message
Gateway
互联网短信网关，向移动用
户发短信使用
金融网关互联网短信网关，向联通用
户发短信使用
CMPP China Mobile Peer to Peer 中国移动点对点协议
EP Enterprise 使用短信平台发送短信的
企业客户端
accountId 登录企业短信平台使用的
账号
account_Code 账号服务代码
SP_CODE 网关服务代码，短信网关认
证用。目前支持的服务代码
上海移动通信企业短信通平台接口协议
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 3 of 15
为02195、02196
Password 登录企业短信平台使用的
密码
EPR_Id Enterprise Id 企业代码
手机用户指企业服务的个人用户
EMPI Enterprise information
management platform
interface
面向企业信息管理的API
接口
Service_Id EP 的计费对象，由数字组
成，
1.4. EMPP 功能概述
EMPP 协议主要提供以下两类业务操作：
（1）短信接收（Short Message Mobile Originate，SM MO）
（2）短信发送（Short Message Mobile Terminated，SM MT）
1.5. 协议栈
EMPP 协议以TCP/IP 作为底层通信承载
1.6. 通信方式
企业端可以在一个TCP 连接上可以连续发送多个数据包，在TCP 连接保持期
间，如果没有数据包发送，需要双方发链路检测包以维持此连接。
1.6.1. TCP 连接
通信双方以客户-服务器方式建立TCP 连接，用于双方信息的相互提交。当
信道上没有数据传输时，通信双方应每隔时间C 发送链路检测包以维持此连接，
当链路检测包发出超过时间T 后未收到响应，应立即再发送链路检测包，再连续
发送N-1 次后仍未得到响应则断开此连接。
参数C、T、N 原则上应可配置，现阶段建议取值为：C=3 分钟，T=5 秒，N=3。
上海移动通信企业短信通平台接口协议
目前服务器端控制每个企业客户连接每秒只能发一条短信。
1.6.2. 本协议涉及的端口号
端口号应用
9981 EP 与ESMP 间短信收发
1.6.3. 交互过程中的应答方式
在EP 与ESMP 之间发送短信时采用异步方式，即客户端在发送一条短信后不
必等待服务器端的响应即可再次发送短信。
ESMP 企业端
EMPP_CONNECT
EMPP_CONNECT_RESP
EMPP_SUBMIT(1)
EMPP_SUBMIT_RESP(1)
EMPP_SUBMIT(2)
EMPP_SUBMIT(3)
EMPP_SUBMIT(4)
EMPP_SUBMIT_RESP(3)
EMPP_SUBMIT_RESP(4)
EMPP_SUBMIT_RESP(2)
EMPP_TERMINATE
EMPP_TERMINATE_RESP
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 4 of 15
上海移动通信企业短信通平台接口协议
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 5 of 15
第2 章消息定义
2.1. 基本数据类型
Unsigned Integer 无符号整数
Integer 整数，可为正整数、负整数或零
Octet String 定长字符串，如果位数不够则右补二进制的0
Binary 可为任意的二进制数据
2.2. 消息结构
项目说明
Message Header 消息头(所有消息公共包头)
Message Body 消息体
2.3. 消息头格式（Message Header）
字段名字节
数
类型描述
Total_Length 4 Unsigned
Integer
消息总长度(含消息头及消息体)
Command_Id 4 Unsigned
Integer
命令或响应类型
Sequence_Id 4 Unsigned
Integer
消息流水号,顺序累加,步长为1,循环
使用（一对请求和应答消息的流水号
必须相同）
2.4. CommnadID 定义
消息Command_Id
值
说明
上海移动通信企业短信通平台接口协议
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 6 of 15
EMPP_CONNECT 0x00000001 请求连接
EMPP_CONNECT_RESP 0x80000001 请求连接应答
EMPP_TERMINATE 0x00000002 终止连接
EMPP_TERMINATE_RESP 0x80000002 终止连接应答
EMPP_SUBMIT 0x00000004 提交短信
EMPP_SUBMIT_RESP 0x80000004 提交短信应答
EMPP_DELIVER 0x00000005 短信回复
EMPP_DELIVER_RESP 0x80000005 回复短信应答
EMPP_ACTIVE_TEST 0x00000008 激活测试
EMPP_ACTIVE_TEST_RESP 0x80000008 激活测试应答
EMPP_INTRINTSEARCHMSG_R
ESP
0x80000010 查询回复短信响应
EMPP_INTRINTSEARCHMSG 0x00000010 查询回复的短信
EMPP_SYNCADDRBOOK 0x00000011 同步通讯录
EMPP_SYNCADDRBOOK_RESP 0x80000011 同步通讯录响应
EMPP_CHANGEPASS 0x00000012 修改密码
EMPP_ CHANGEPASS _RESP 0x80000012 修改密码响应
EMPP_QUESTION 0x00000013 企业疑问
EMPP_QUESTION_RESP 0x80000013 企业疑问响应
EMPP_ANSWER 0x00000014 企业疑问解答
EMPP_ANSWER_RESP 0x80000014 企业疑问解答响应
EMPP_REQNOTICE 0x00000015 请求运营商发布信息
EMPP_REQNOTICE_RESP 0x80000015 运营商发布信息响应
EMPP_SUBMIT2 0x00000016 双重认证短信
EMPP_UNAUTHORIZATION 0x80000017 未授权响应
EMPP_INTRINTMSGSTATE 0x00000018 查询短信状态
EMPP_INTRINTMSGSTATE_RES
P
0x80000018 查询短信状态响应
2.5. EP 请求连接到ESMP（EMPP_CONNECT）操作
EMPP_CONNECT 操作的目的是EP 向ESMP 注册作为一个合法EP 身份，若注
册成功后即建立了应用层的连接，此后EP 可以通过此ESMP 接收和发送短信。
上海移动通信企业短信通平台接口协议
上海移动通信有限责任公司规划设计研究中心暨数据业务中心
Page 7 of 15
ESMP 以EMPP_CONNECT_RESP 消息响应EP 的请求。
字段名字节数属性描述
accountId 21 Octet
String
此处为发送短信的账号，从右向
左的四个字节为EP 的特服号(目
前为5555)，其次从右向左的5
个字节为企业ID，后三个字节为
企业内部员工的标识(可选)
AuthenticatorSource 16 Octet
String
用于鉴别源地址。其值通过单向
MD5 hash 计算得出，表示如下：
AuthenticatorSource =MD5
（accountId+9 字节的0(二进制
的0) +password+timestamp ）
timestamp 格式为：
MMDDHHMMSS，即月日时分
秒，10 位。
Version 1 Unsigned
Integer
EMPP 的版本号(高位4bit 表示主
版本号,低位4bit 表示次版本号)，
对于目前1.0 的版本，高4bit 为1，
低4 位为0
Timestamp 4 Unsigned
Integer
时间戳的明文,由EP 产生,格式为
MMDDHHMMSS，即月日时分
秒，10 位数字的整型，右对齐。
EMPP_CONNECT_RESP消息定义（ESMP