第1章短信订购及上行协议 .doc

运营商协议规范 （V1.0.0） 武汉恒枫伟业科技有限公司 2015年12月 修订记录 版本号 修订人 修订日期 修订描述 文档目录 文档目录 3 1 简介 4 2 网关模拟器 4 2.1移动短信CMPP模拟器 4 模拟器的安装 4 启动模拟器 5 关闭模拟器 5 模拟器的使用 5 模拟器的监控 7 模拟器的常见问题 10 2.2联通短信SGIP模拟器 13 模拟器的安装 13 启动模拟器 14 关闭模拟器 14 模拟器的使用 14 模拟器的监控 15 模拟器的常见问题 18 2.3电信短信SMGP模拟器 21 模拟器的安装 21 启动模拟器 22 关闭模拟器 22 模拟器的使用 22 模拟器的监控 24 模拟器的常见问题 27 3 客户端测试程序 30 3.1移动CMPP短信网关API 30 3.2联通SGIP短信网关API 31 3.3电信SMGP短信网关API 31 4 网关常见错误代码 (The List of Error Code) 31 5 附件 32 5.1参数说明 32 5.2注意事项 32 简介 本文档是任信鸟平台为客户提供了接入CMPP2、CMPP3、SGIP、SMGP三种标准协议接入指南，本指南目的是帮助用户通过CMPP2、CMPP3、SGIP、SMGP协议快速连接上任信鸟平台，已达到提高发送效率的目的。 使用流程 用户分别下载好2、3中相应的网关模拟器程序和客户端测试程并测试好， 找任信鸟平台获取到所需要参数，具体参数值见附件5.1 报备鉴权IP给任信鸟后台 测试客户端程序修改好参数，然后做测试 网关模拟器 网关模拟器（Gateway Simulator）种类非常多，而且版本比较多。在这里特别将他们进行整理归类，避免使用上的混淆。所提供的模拟器均为纯Java编写，不存在任何不安全因素或者后门。 2.1移动短信CMPP模拟器 CMPP模拟器主要是模拟使用中国移动CMPP协议（版本1.x～3.x）的各种网关。此类型网关只使用一个收发连接（短信接收和发送在一个链接上进行）。 模拟器要求使用JDK1.4以上的Java运行环境，请确认相关环境已经安装妥当。如果还没有安装Java环境，请访问下载最新J2SE的SDK。 此模拟器已经使用了全新的核心设计，主要针对应用程序的稳定性、可靠性、效率以及配置、管理和监控方面做了很大的调整。基本界面风格和应用功能上没什么变化。 模拟器的安装 模拟器整个是一个压缩包。点击链接下载模拟器：CMPPSimulator.zip、CMPP3Simulator.zip；点击链接下载协议：CMPP v1.2、CMPP v3.0。 如果熟悉模拟器的配置文件，则可以通过直接修改配置文件来设定模拟器的工作方式。有关模拟器可能出现的各种问题请参考“模拟器相关问题”。 解包以后应该可以看到目录结构。其中bin目录是存放运行程序包的目录；CMPPSimulator目录存放配置文件（config.xml）、启动命令（startup.bat/startup.sh）和关闭命令（shutdown.bat/shutdown.sh）。 Bat文件是windows环境下使用的启动和关闭命令；Shell文件是Unix系统下使用的启动和关闭命令。下面主要以Windows环境进行讲解，Unix下基本类似。 如果Java运行环境安装正确，则可以直接运行和关闭，无需安装其他软件或者运行包。 启动模拟器 启动模拟器只需要运行startup.bat即可。 正常启动后，会出现一个Console窗口，最后会提示：“SimulatorCenter.main : system startup !” 关闭模拟器 关闭模拟器只需要输入quit命令即可，或者运行shutdown.bat。 正常关闭后，Console窗口中应该最后会提示：“TaskManager.uninitialize : process manager was uninitialized !” 模拟器的使用 模拟器启动以后使用缺省配置端口7890进行通讯。 缺省配置的企业代码是：999999；特别服务号码（也称长号码）是9999；用户名是333；密码是0555。这些配置可以在config.xml中找到： !-- These are all authentications of gateway. -- authenticate name=whoami