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

上海移动通信
企业短信通平台接口协议
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

上海移动通信企业短信通平台接口协议相关推荐

商务短信通平台-- 建设实施方案
商务短信通平台-- 建设实施方案目录第一章商务短信平台概述.... 2 1．1 概述... 2 1．2 目的... 2 1．3 范围... 2 第2章商务短信平台功能.... 2 2．1 商务 ...
使用SMS网建短信通平台发送短信-Java示例
中国网建短信平台接口 http://www.smschinese.cn/api.shtml 步骤: 1. 短信通平台用户注册: http://www.smschinese.cn/reg.shtml 2 ...
sms 短信通平台发送短信
1.首先需要一个账户 2.导入jar包 import java.io.UnsupportedEncodingException; import org.apache.commons.httpc ...
Java利用中国网建SMS短信通平台发送手机短信
JAVA发送手机短信,流传有几种方法: (1)使用webservice接口发送手机短信,这个可以使用sina提供的webservice进行发送,但是需要进行注册; (2)使用短信mao的方式进行短信的 ...
中国移动企业短信通平台EMPP协议分析
中国移动企信通地址:http://sms.sh.chinamobile.com/qxt/index.jsp 最近要为手上一个项目设计短信发送,简单分析了一下,最终将使用中国移动企信通作为工具.简单总结 ...
小豆社保「社保代缴」短信接口被盗刷解决方案-企业短信防火墙
1 小豆社保业务及需求半夜短信费用完, 怎么知道是否有问题? 小豆社保:是一家一站式人力资源SAAS服务云智慧平台,隶属于北京新琪科技有限公司, 说简单点就是解决工作变动无挂靠单位的人代缴社保的业务 ...
短信接口被恶意调用？企业短信防火墙+【中昱维信】短信验证码【Java】
短信接口被恶意调用?企业短信防火墙+[中昱维信]短信验证码[Java] 一.企业短信防火墙的实现 1.1 简介 1.2 第一步:获取防火墙帐号密钥 1.3 第二步:下载防火墙服务器 1.4 第三步:业 ...
短信接口防刷防轰炸解决方案Java接入教程- 企业短信防火墙+ 【中昱维信】短信验证码
企业短信防火墙[新昕科技]+短信验证码[中昱维信]Java应用实例一.企业短信防火墙的实现 1.1 简介 1.2 第一步:获取防火墙帐号密钥 1.3 第二步:下载防火墙服务器 1.4 第三步:业务系 ...
企业短信防火墙应用-爱侬「北京市家政服务龙头企业」
▌1. 爱侬网站及需求董事长:穆丽杰女士既是政协石景山区第十届委员会委员,也是爱侬家政服务的创始人. 北京家政服务协会会长,北京爱侬养老科技发展股份有限公司董事长. 史总: 爱侬技术负责人 ( 需 ...

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

上海移动通信企业短信通平台接口协议相关推荐

最新文章

热门文章