中国电信短消息网关协议(SMGP协议)(v1.3)
- 格式:doc
- 大小:544.50 KB
- 文档页数:29
中国电信综合业务接入网关(ISAG )开放接口技术规范MMS RC 1.1.0中国电信集团公司 发布保密等级:公开发放江苏电信专用2 中国电信综合业务接入网关(ISAG )开放接口技术规范目 录1范围 ......................................................................... 4 2规范引用性文件 ............................................................... 错误!未定义书签。
3缩略语 ....................................................................... 6 4服务概述 ..................................................................... 8 5序列图 ....................................................................... 9 6数据类型 ..................................................................... 10 6.1 DeliveryStatus ............................................................ 10 6.2 DeliveryInformation ....................................................... 10 6.3 MessageReference .......................................................... 10 6.4 MessageURI ................................................................ 11 6.5 MessagePriority ........................................................... 11 7接口定义 ..................................................................... 12 7.1接口:SendMessage .......................................................... 12 7.2接口:GetMessage ........................................................... 15 7.3接口:MessageNotification .................................................. 18 8差错定义 ..................................................................... 20 9服务策略 (21)江苏电信专用中国电信综合业务接入网关(ISAG )开放接口技术规范 3前 言本系列规范由八项规范组成,名称如下: 中国电信综合业务接入网关ISAG 总体技术规范 中国电信综合业务接入网关ISAG 设备技术规范 中国电信ISAG Router 设备技术规范中国电信综合业务接入网关ISAG 开放接口技术规范中国电信综合业务接入网关ISAG 协议映射南向接口技术规范 中国电信综合业务接入网关ISAG 路由接口技术规范 中国电信综合业务接入网关ISAG 业务流程技术规范 中国电信综合业务接入网关ISAG 业务测试规范本系统规范主要依据3GPP 和OMA 的有关规范和信息产业部颁布的相关行业技术标准编制。
技术部分1、信息推送的技术方案信息流是继物流和资金流而后的更为重要的企业命脉所在,如何协调和理顺企业的信息流转通道和速度,就成为行业竞争成败的关键所在。
随着计算机和网络技术的广泛应用,信息化的浪潮席卷了整个中华大地,各企业、行业、政府纷纷建立电子办公、电子商务、电子政务等等信息化系统。
随着人们、企业、行业之间的联系越来越密切,合作以及商务关系日趋频繁,这种仅仅依赖于计算机系统的信息化已经不能满足信息不断腾飞的趋势。
移动通信技术的不断进步和发展给信息传递提供了新的方式,人们也逐渐意识到只有做到了移动信息化才能真正满足当前信息时代的要求。
一、短消息接入方式企业短消息应用架构将短消息应用到企业领域,其应用架构可分为三个层面:接入平台、应用支撑平台、应用系统。
●接入平台通过无线网络或者有线网络完成短消息的协议适配和接收发送。
无线接入方式采用GSM/CDMA空中接口,通过移动网络将短消息发送到短消息中心或网关;有线接入方式利用互联网或专用网络直接接入短消息中心或网关。
●应用支撑平台介于应用系统和接入平台之间,向应用系统提供基本的通用短消息服务。
这些服务包括短消息单发,短消息群发,短消息定时发送,短消息用户的鉴权和用户管理,短消息负载平衡和流量控制等。
这些服务和具体应用需求独立,但却是所有应用系统必不可少的功能。
在实际应用中,该层往往和应用系统紧密集成在一起。
●应用系统包括各种面向应用的系统。
这些系统有企业办公系统(OA)、邮件系统、C财务系统、ERP等等;另外还包括和行业应用密切相关的应用系统。
这些系统利用应用服务层提供的短消息服务接口,专注于各自的应用逻辑。
诸如企业QQ等就是属于这个层次的短信应用系统。
企业短消息应用思路企业在开展短消息应用的时候,一般会有三种思路:第一种是采用运营商面向企业应用的短消息平台,申请开通企业短消息业务;第二种是采用短消息服务提供商(如ISP/ICP)的企业短消息平台;第三种是自建企业短消息中心。
第一章 SMGP协议的封装SMGP协议封装在m.smgp.message包中,主要消息如下(1)SMGPActiveTestMessage 心跳消息,对应SMGP文档中的active_test消息,是SMGPSMProxy与网关的心跳消息。
(2)SMGPActiveTestRespMessage 心跳响应消息,对应SMGP文档中的active_test_resp,是SMGPSMProxy发送心跳消息后收到的响应消息(3)SMGPDeliverMessage 网关下发短信,对应SMGP文档中的deliver消息,是网关下发给SMGPSMProxy的短消息或者状态报告消息。
(4)SMGPDeliverRespMessage 下发短信响应,对应SMGP文档中的deliver_resp消息,是SMGPSMProxy收到的下发短信后的响应消息。
(5)SMGPExitMessage 终止连接消息,对应SMGP 文档中的exit消息,是网关和SMGPSMProxy终止逻辑连接的消息。
(6)SMGPExitRespMessage 终止连接的响应消息,对应SMGP 文档中的exit_resp消息,是网关或SMGPSMProxy收到终止连接后发送的响应消息。
(7)SMGPForwardMessage 消息,对应SMGP 文档中的forward消息。
(8)SMGPForwardRespMessage 消息,对应SMGP 文档中的forward_resp消息。
(9)SMGPLoginMessage 请求连接消息,对应SMGP文档中的login消息,是SMGPSMProxy向网关发送的建立逻辑请求连接消息。
(10)SMGPLoginRespMessage 请求连接应答消息,对应SMGP文档中的login_resp消息,是SMGPSMProxy向网关发送的建立逻辑请求连接后收到的响应消息。
(11)SMGPMoRouteUpdateMessage 消息,对应SMGP 文档中的mo_route_update消息。
一、网关介入说明1 网关接入运营商网关接入有2种方式,推荐专线接入安全可靠不易丢包。
如果是互联网推荐使用防火墙隔离出互联网DMZ区,保证安全。
1.1 专线接入专线接入:下图只做参考,各省可根据实际情况在保证网络安全前提下进行划分网络。
移动运营商如果提供MAS机可以和短信平台部署一个网段,MAS机可认为移动的前端网关服务器,它是为了方便移动管理和维护以与安全考虑提供一台MAS机。
注意:Mas机是部署在和短信平台同一个局域网内。
如果接入Mas机,由于全国MAS厂商很多,所以要主要短信平台和MAS机的连接方式,目前支持的方式:直接提供MAS机的ip,端口配置在短信平台的网关参数配置中。
如果是提供相关的api、接口或者数据库连接方式,目前不支持这几种方式,这几个方式出问题了不是很好管理,出现问题不好解决。
如果Mas是这样连接的话,请直接采用网关直连的方式。
如果是只提供ip和端口就可以了,就相当于mas机就是移动的短信业务平台,就很好管理了,就算有问题也只有网络方面的1.2 互联网接入互联网接入:下图只做参考,各省可根据实际情况在保证网络安全前提下进行划分网络。
移动运营商如果提供MAS机可以和短信平台部署一个网段,MAS机可认为移动的前端网关服务器,它是为了方便移动管理和维护以与安全考虑提供一台MAS机。
2 网关参数2.1 移动参数短信平台支持移动CMPP2、CMPP3.0协议,需要运营商提供参数如下:特服:12379,短信平台必填项企业代码:移动运营商提供企业id,短信平台必填项网关地址:移动运营商提供网关服务器ip地址,短信平台必填项网关端口:移动运营商提供网关服务器端口号,短信平台必填项登录名称:移动运营商提供登录网关用户名,短信平台必填项登录密码:移动运营商提供登录网关密码,短信平台必填项业务代码:移动运营商提供业务类型,没有提供则为空2.2 电信参数短信平台支持电信SMGP3.0和ISAG协议,SMGP协议需要运营商提供参数如下:特服:12379,短信平台必填项企业代码:电信运营商提供企业id,短信平台必填项网关地址:电信运营商提供网关服务器ip地址,短信平台必填项网关端口:电信运营商提供网关服务器端口号,短信平台必填项登录名称:电信运营商提供登录网关用户名,短信平台必填项登录密码:电信运营商提供登录网关密码,短信平台必填项业务代码:电信运营商提供业务代码,没有提供则为空ISAG协议需要运营商提供参数如下:特服:12379,短信平台必填项企业代码:电信运营商提供企业id,短信平台必填项网关地址:电信运营商提供网关服务器访问地址“://网关IP:网关端口”,短信平台必填项登录名称:电信运营商提供登录网关用户名,短信平台必填项登录密码:电信运营商提供登录网关密码,短信平台必填项服务代码:电信运营商提供服务代码,没有提供则为空产品代码:电信运营商提供产品代码,没有提供则为空回调地址:默认填写://短信平台IP:8080/asp/sms/SmsWebService,短信平台必填项2.3 联通参数短信平台支持联通SGIP1.2协议,需要运营商提供参数如下:特服:12379,短信平台必填项企业代码:联通运营商提供企业id,短信平台必填项网关地址:联通运营商提供网关服务器ip地址,短信平台必填项网关端口:联通运营商提供网关服务器端口号,短信平台必填项登录名称:联通运营商提供登录网关用户名,短信平台必填项登录密码:联通运营商提供登录网关密码,短信平台必填项本地端口:短信平台自身提供,默认8801,短信平台必填项业务代码:联通电信运营商提供业务代码,没有提供则为空源节点ID:联通电信运营商提供源节点ID,没有默认填写02.4 配置参数短信平台支持5种协议,根据运营商提供的协议短信平台选择对应的协议,然后再进行每个协议的详细参数配置,参数配置完成点击“保存”按钮,在点击“停止”按钮,最后点击“启动”按钮,刷新当前页面查看状态指示灯是否为绿色,绿色代表短信平台与网关服务器联通。
短信平台解决方案上海双杨电脑高科技开发公司2009年7月一、概要说明 (4)1.背景 (4)2.建设目标 (5)二、平台架构 (5)1.网络架构 (5)2.系统架构 (7)三、功能模块 (7)1.通讯协议模块 (8)2.业务处理模块 (9)3.平台监控模块 (9)4.数据管理模块 (10)5.第三方接口 (19)四、支持协议 (21)1.支持中国移动CMPP协议及MISC系统 (21)2.支持中国联通SGIP协议 (22)3.支持中国电信SMGP协议 (22)4.支持中国网通CNGP协议 (22)5.支持SMPP协议 (22)五、平台特色 (22)六、系统安全策略 (23)1.管理上 (23)2.技术上 (24)七、硬件配置要求 (26)1.系统平台硬件配置图 (26)八、软件配置 (28)1.数据库系统 (28)2.应用服务器 (28)3.客户端操作系统 (28)4.浏览器 (28)5.编辑器支持 (28)九、质量体系框架 (28)1.质量管理职责 (28)a)我公司负责以下职责 (28)b)贵方应负的职责 (29)2.质量体系 (29)3.审核 (30)4.纠正措施 (30)5.质量体系生存周期 (30)a)合同评审 (31)b)验收准则 (31)c)需求规格说明 (31)十、系统开发实施计划 (32)1.质量计划 (32)3.试和确认 (33)4.验收 (34)5.复制、交付和安装 (34)6.维护 (35)一、概要说明1.背景手机,目前是一种已经普及的用户终端,采用手机短信实现通知的功能已经是一种最佳、最方便、最便宜的途径。
要实现通知具有几百个、上千个、上万个人员,如果采用人工方法通过打电话或手工发手机短信的方式,是一件很费事的事情,而且工作效率低,一些紧急事务可能通知不了。
解决这种问题的办法是采用计算机系统进行自动化处理。
一般有两种方式,一种是通过委托短信服务提供商(ISP)实现短信群发通知。
中国联合通信公司短消息网关系统接口协议(SGIP)版本1.2中国联合通信公司二零零一年十月目录1概述 (1)1.1协议说明 (1)1.2适用范围 (1)1.3参考资料 (1)1.4术语表 (1)2系统体系结构 (3)2.1消息从本地SMSC到本地SP (4)2.2消息从本地SP到本地SMSC (4)2.3消息从本地SMSC到异地SP (4)2.4消息从本地SP到异地SMSC (4)2.5路由选择 (4)3通信流程 (6)3.1专用SGIP方式 (6)3.2通用HTTP方式 (6)3.3通信节点编号规则 (7)3.4序列号的定义 (7)3.5通信的安全性 (8)3.6用户鉴权 (8)3.6.1被叫方付费 (8)3.6.2SP付费 (8)3.6.3第三方付费 (8)3.7SP与SMG的通信 (9)3.7.1通用HTTP方式 (9)3.7.1.1从SP到SMG的命令 (10)3.7.1.2从SMG到SP的命令 (10)3.7.2专用SGIP方式 (10)3.7.2.1通信初始化 (10)3.7.2.2通信过程 (11)3.7.2.3通信结束 (12)3.7.2.4故障处理 (12)3.7.2.5从SP到SMG的消息 (13)3.7.2.6从SMG到SP的消息 (13)3.8SMG与SMG之间的通信 (14)3.8.1通信初始化 (14)3.8.2通信过程 (14)3.8.3通信结束 (15)3.8.4故障处理 (15)3.8.5两个SMG之间的消息 (15)3.9SMG与GNS之间的通信 (15)3.9.1通信初始化 (15)3.9.2通信过程 (16)3.9.3通信结束 (16)3.9.4故障处理 (16)3.9.5从SMG到GNS的消息 (16)3.9.6从GNS到SMG的消息 (17)4消息定义 (18)4.1基于通用HTTP的消息定义 (18)4.1.1Submit操作 (18)4.1.1.1Submit命令的请求内容 (18)4.1.1.2Submit命令的应答内容 (19)4.1.2Deliver操作 (20)4.1.2.1Deliver命令的请求内容 (20)4.1.2.2Deliver命令的应答内容 (20)4.1.3Report操作 (21)4.1.3.1Report命令的请求内容 (21)4.1.3.2Report命令的应答内容 (21)4.1.4UserRpt操作 (22)4.1.4.1UserRpt命令的请求内容 (22)4.1.4.2UserRpt命令的应答内容 (22)4.1.5Trace操作 (22)4.1.5.1Trace命令的请求内容 (22)4.1.5.2Trace命令的应答内容 (23)4.2基于专用SGIP的消息定义 (23)4.2.1数据类型 (23)4.2.2消息头的格式 (24)4.2.3消息体的格式 (24)4.2.3.1Bind操作 (24)4.2.3.2Unbind操作 (25)4.2.3.3Submit操作 (25)4.2.3.4Deliver操作 (28)4.2.3.5Report操作 (29)4.2.3.6AddSP操作 (29)4.2.3.7ModifySP操作 (30)4.2.3.8DeleteSP操作 (31)4.2.3.9QueryRoute操作 (31)4.2.3.10AddTeleSeg操作 (32)4.2.3.11ModifyTeleSeg操作 (33)4.2.3.12DeleteTeleSeg操作 (34)4.2.3.13AddSMG操作 (34)4.2.3.14ModifySMG操作 (35)4.2.3.15DeleteSMG操作 (35)4.3鉴权消息定义 (36)4.3.1CheckUser命令的语法 (36)4.3.2CheckUser_Resp应答的语法 (36)4.3.3UserRpt命令的语法 (36)4.3.4UserRpt_Resp应答的语法 (36)4.4测试消息定义 (37)4.4.1Trace命令的语法 (37)4.4.2Trace_Resp应答的语法 (37)5常量定义 (38)5.1消息ID定义 (38)5.2错误码定义 (38)5.3计费类别定义 (39)5.4R EPORT 状态与短消息状态的映射 (39)附录1: 全网路由表的格式示范 (40)附录2: 本地路由表的格式示范 (41)附录3: HTTP承载方式示范 (42)1概述1.1协议说明本协议是SMG和SP之间、SMG和GNS之间、以及SMG和SMG之间的接口协议,简称SGIP。
中国电信短信接入A P I使用手册(D B接口)中国电信股份XXXX互联网与增值业务运营中心2009年10月目录一、引言31.1 编写目的31.2 背景说明31.3 术语定义3二、概述42.1 接口功能42.2 接口组成4三、接口介绍53.1 网络结构53.2 运行环境6操作系统6数据库系统63.3 数据队列6发送队列表6接收队列表7回执队列表73.4 DB接口开发说明8四、使用指导84.1 开发步骤8一、引言1.1 编写目的中国电信提供了强大的短信接入机制。
本手册用于指导客户利用中国电信提供的短信接口进行其他需要短信功能的新系统开发或原有系统的短信功能扩展。
本手册的阅读对象为需要采用中国电信短信接入API完成客户开发的设计人员与编码人员。
1.2背景说明本手册适用于中国电信SMGP协议(V)短信网关接入。
1.3术语定义二、概述2.1 接口功能中国电信短信接入API是根据中国电信SMGP协议开发的,封装后的用户开发接口。
接口可降低用户接入开发的难度,提升接入效率。
接口主要功能包括:⏹支持MT短信的发送。
⏹支持MO短信的接收。
⏹支持短信回执的接收。
2.2 接口组成中国电信短信接入API包括如下部分:三、接口介绍3.1 网络结构网络结构说明:1、行业短信网关接入模块:提供到各地短信中心的接入功能,同时与全国行业应用平台实现互连;2、行业短信平台业务处理模块:主要完成短信上行和下行的业务处理,短信下发,无论是单发,还是群发,无论是单个用户,还是多个用户,都采用下发任务机制实现。
3、行业短信网关置于电信机房,集团客户端可通过互联网或专线与其连接。
4、集团客户端的各类信息系统是通过向接口数据库进行数据读写操作,实现短信上、下行。
3.2运行环境3.2.1操作系统DB接口程序支持WINDOWS NT/XP/2003/VISTA操作系统,暂不支持LINUX、UNIX 等。
3.2.2数据库系统DB接口自带ACCESS数据库,可在本机架设。
中国电信集团公司企业标准CT/T 1-2001基于固定电话网的信息终端及综合信息系统技术规范第七分册短消息网关(SMGP)协议 V1.32002-04-30发布 2002-04-30实施中国电信集团公司发布目录前言 (2)1 适用范围 (3)2 引用标准 (3)3 缩略语 (3)4 SMGP概述 (3)4.1. SMGP功能 (3)4.2. SMGP定义 (3)4.3. SMGP通信流程 (4)5 SMGP数据包定义 (6)5.1. 数据包结构 (6)5.2. 请求标识说明 (6)5.3. 包体结构 (7)6 编码说明 (15)6.1. 短消息格式代码表 (15)6.2. 收费类型代码表 (15)6.3. 短消息状态表 (16)6.4. Err错误代码表 (16)6.5. Status错误代码表 (17)7 基于SMGP协议的API函数 (17)附录A 基于SMGP协议的API函数说明 (18)(提示的附录) (18)A.1基本要求 (19)A.2 API数据结构说明(以C语言为例) (19)A.3 API函数说明 (21)A 3.7查询短消息流量(SMGPQuery可选) (25)A.4配置SMGP API (25)A.5短信的自动分割功能 (26)A.6错误代码含义 (27)前言本标准介绍综合信息系统短消息网关和内容提供商(CP)之间、短消息网关和短消息网关之间的通信协议。
本协议简称SMGP(Short Message Gateway Protocol)。
本标准起草单位:中国电信集团公司、中国电信集团公司上海研发中心本标准主要起草人:特别感谢:亚信科技中国有限公司在本协议制订过程中的大力支持和帮助。
1适用范围本协议适用于短消息网关开发商和短消息内容提供商。
2引用标准SMPP (Short Message Peer to Peer Protocol Specification) v3.33缩略语见总册4SMGP概述4.1.SMGP功能SMGP协议是内容提供商与短消息网关,以及短消息网关与短消息网关之间的通信协议。
SMGP可以实现以下功能:(1)内容提供商向综合信息系统短消息用户发送短消息,例如邮件通知、天气预报等。
(2)综合信息系统短消息用户向内容提供商点播信息,例如股票查询、航班信息等。
(3)内容提供商以某个短消息用户的身份向综合信息系统短消息用户发送传情信息,例如图片传情、音乐传情等。
(4)综合信息系统短消息用户发送的短消息通过短消息网关前转发送给异地的短消息用户。
4.2.SMGP定义SMGP协议是一个基于数据包的交互式协议,底层通过TCP/IP协议传递数据。
每个数据包都包含请求标识,代表数据包的用途。
内容提供商与短消息网关或者短消息网关与短消息网关之间采用Client/Server方式交互信息,客户端向服务器端发送一个请求包,服务器端向客户端返回回应包。
客户端发送的所有请求包都包含一个唯一的序列号,服务器端返回的回应包也带有相应的序列号,以便客户识别这是哪一个请求的回应。
客户端和服务器端之间可以采用长连接或者短连接的方式通信。
如果采用短连接,客户端必须以发送者、接收者或收发者的身份登录到服务器,通信完毕后断开连接。
如果采用长连接,一旦认证通过建立连接,客户端与服务器端可以随时通信,在一定时间内两者之间没有发送合法的请求包,连接就中断。
4.3.SMGP通信流程网关与CP之间通信连接采用端口号8890,网关与网关通信连接采用端口号8900。
4.3.1.SMGP登录模式在SMGP协议的一个会话中客户端可以采用三种登录方式与服务器端相连:发送模式(send mode)、接收模式(receive mode)和收发模式(transmit mode)。
在发送模式中客户端只能发送短消息、在接收模式中客户端只能接收短消息、在收发模式中客户端既可以发送也可以接收短消息。
三种模式均可以采用长连接与短连接两种连接方式的一种,根据实际情况选择。
4.3.2.CP发送短消息CP以发送者或者是收发者身份登录后,就可以发送短消息。
CP可以不等待上一个短消息发送回应包,就发送下一个短消息。
4.3.3.CP接收短消息CP以接收者或者是收发者身份登录后,短消息网关就向CP发送短消息,短消息网关可以不等待上一个短消息回应包,就发送下一个短消息。
CP SMGW4.3.4.SMGW转发短消息短消息网关需要把异地MT/MO短消息转发到相应的短消息网关,在转发短消息之前短消息网关需要通过对方网关认证。
CP SMGW5SMGP数据包定义5.1.数据包结构SMGP数据包分为包头和包体两部分,包头的结构如下:5.2.请求标识说明请求标识(RequestID)标识数据包的类型,请求包的请求标识和回应包的请求标识一一对应。
5.3.包体结构5.3.1.login5.3.2.login_resp5.3.4.submit_resp5.3.5.deliver5.3.6.deliver_resp5.3.7.active_test没有包体5.3.8.acitve_test_resp没有包体5.3.9.forward5.3.10.forword_resp5.3.11.exit没有包体5.3.12.exit_resp没有包体5.3.13.query(保留)5.3.14.query_resp (保留)1当Query_Type为0时,此项无效;当Query_Type为1时,此项填写业务代码Service_id.5.3.15.mt_route_update (保留)5.3.16.mt_route_update_resp (保留)5.3.17.mo_route_update(保留)5.3.18.mo_route_update_resp(保留)5.3.19.状态报告格式6编码说明6.1.短消息格式代码表6.2.收费类型代码表6.3.短消息状态表6.4.Err错误代码表注:err错误代码的定义对应了SMPP协议包头中command_status字段的相应状态值。
6.5.Status错误代码表7基于SMGP协议的API函数详见附录A。
附录A 基于SMGP协议的API函数说明(提示的附录)A.1基本要求A.1.1安装网关需要提供API软件包,解压到指定目录下后可以修改配置文件,配置参数至少包括IcpId(ICP编号)、IcpShareKey(ICP密码)、ClientIP(客户主机的IP地址)和ServerIP(短信网关地址)。
A.1.2例子程序网关至少应该提供以下例程,供ICP调试使用,分别为:●Connect(参数),检查是否能够成功登录短消息网关;●TestAPI(参数),检查是否能够成功连接短信网关。
●SetKey (参数),修改ICP密码。
●SendSM(参数)尝试发送短信。
●RecvSM(参数)尝试接收短信等。
●RecvSMReport(参数),尝试接收短消息状态报告。
A.1.3操作系统平台要求网关提供的API软件包至少要求支持以下操作系统平台:●Free BSD 3.x, 4.2●Solaris 5.6, 5.7, 5.8(包含x86)●Linux(Redhat和Slack等主流产品)●Windows NT/2000等网关提供的API软件包至少要求支持以下编程语言:●C/C++●JA V AA.2 API数据结构说明(以C语言为例)A.2.1接收短信的返回数据结构(DeliverResp)●用途保存SMGPDeliver函数返回的短信内容。
A.2.2获取群发短信的返回数据结构(SendBatchResp)●用途使用SMGPSendBatch群发短信后,每条短信的“消息标识”和“错误代码”保存在文件里。
SMGP API提供GetSendBatchResp函数获取每一条短信返回信息,保存在SendBatchResp中。
A.2.3查询短消息网关的返回数据结构(QueryResp可选)●用途保存SMGPQuery函数返回的查询结果。
A.3 API函数说明A.3.1初始化API(InitSMGPAPI)●作用初始化SMGP API,应用程序只需要调用一次此函数。
●返回0=成功1=失败A.3.2发送单条短信(SMGPSendSingle)●作用向短消息网关发送1条短消息到1个终端用户。
短消息长度最长为200,SMGP API在发送时自动建立Connection Pool,采用长连接或者短连接发送短消息。
当Cache的connection中断时,API能够自动重新连接短消息网关。
如果应用程序采用多线程发送短消息,多个线程共享同一个Connection Pool。
在发送过程中,如果因为通信原因导致发送失败,API能够自动重新发送,重试的次数在配置文件设置。
●返回0=成功1=失败A.3.3群发短信(SMGPSendBatch)●作用向短消息网关发送1条短消息到多个手机用户。
短消息长度最长为200,此函数使用文件传递短消息内容。
SMGP API在发送时自动建立Connection Pool,采用长连接或者短连接发送短消息。
当Cache的connection中断时,API能够自动重新连接短消息网关。
如果应用程序采用多线程发送短消息,多个线程共享同一个Connection Pool。
在发送过程中,如果因为通信原因导致发送失败,API能够自动重新发送,重试的次数在配置文件设置。
●返回0=成功1=失败A.3.4获取群发短信的结果(GetSendBatchResp)●作用从文件里读取群发的某一个短信的标识、发送结果和发送号码。
●返回0=成功1=失败A.3.5接收短信(SMGPDeliver)●作用连接短信网关,等待接收属于本ICP的短信。
●返回0=成功1=失败A.3.6检查短信网关是否能够提供服务(CMMPActiveTest)●作用检查短信网关是否能够提供服务。
●返回0=成功1=失败A 3.7查询短消息流量(SMGPQuery可选)●作用向短消息网关查询某天的短消息流量。
●返回0=成功1=失败A.4配置SMGP APIWithPrevPage第1个以后的分割短消息的前置说明文字,可以为空。
A.5短信的自动分割功能SMGPSendSingle和SMGPSendBatch提供自动分割短消息的功能,分割的效果由smgpc.ini的配置控制。
当参数nMsgFormat等于0或15时,API就提供分割短消息功能。
API扫描短消息的内容,把短消息分段,根据每一段的短消息内容设置nMsgFormat。
如果某一段短消息含有中文,就把那一段短消息的发送格式设为15,取PageSpaceGB为最大长度;如果不含中文,就把那一段短消息的发送格式设为0,取PageSpaceAscii为最大长度。