联通短信网关SP端应用程序接口使用说明(sgip1.2)
{业务管理}中国联通短消息业务设备规范三分册联通在信网关设备规范
{业务管理}中国联通短消息业务设备规范三分册联通在信网关设备规范中国联通短消息业务设备规范第三分册：联通在信网关设备规范（V2.0）中国联通公司发布修改记录目次修改记录I前言VI1范围12规范性引用文件13缩略语14短消息业务网络结构35系统功能45.1协议转换45.2存储转发45.3SP接入55.4安全鉴权55.5业务处理55.6计费65.7网管接口功能75.8GNS节点功能75.9支持号码携带75.10支持上网卡用户屏蔽联通在信功能75.11SPMS功能76业务流程96.1可信任SP业务流程96.1.1可信任SPMO业务流程96.1.2可信任SPMT业务流程106.2普通SP业务流程106.2.1屏蔽/解除屏蔽业务流程106.2.2查询业务流程116.2.3MO短信定制业务流程126.2.3.1Webservice通知SP126.2.3.2SGIP通知SP146.2.4SP网站定制流程166.2.4.1Webservice通知SP166.2.4.2SGIP通知SP176.2.5MO短信退订业务流程206.2.5.1Webservice通知SP206.2.5.2SGIP通知SP216.2.6点播流程（包括上下行计费，ProductType=2）21 6.2.6.1Webservice通知SP216.2.6.2SGIP通知SP226.2.7直接使用类流程（ProductType=3）236.2.8点播流程（SP网站）246.2.9定制业务/点播下行计费类业务MT流程266.2.10用户指令错误流程266.2.10.1SGIP通知SP266.2.10.2Webservice通知SP276.2.11CRM侧定制/退订流程286.2.11.1Webservice通知SP286.2.11.2SGIP通知SP296.2.12用户在SP网站退订/SP客服退订流程29 6.2.12.1Webservice通知SP296.2.12.2SGIP通知SP307系统接口317.1SMG与SPMS的接口317.2SMG与SP的接口317.3SMG与SMSC的接口327.4SMG与SPSMG其他SMG的接口337.5SMG/SPMS与网管系统的接口337.6省分SPMS与省分VAC的接口337.7省分SPMS与SP的接口348系统管理348.1SMG系统管理348.1.1系统配置348.1.2服务控制348.2SPMS系统管理348.2.1系统配置348.3日志管理349设备要求359.1硬件359.1.1处理主机359.1.2传输线路359.2系统软件359.2.1操作系统359.2.2应用系统359.2.3开发平台3510系统性能要求35附录A（规范性附录）联通在信网关话单格式37A.1短消息发送话单（MO）格式37A.2短消息接收话单（MT）格式38A.3联通在信网关转发话单（MO-F）格式39A.4联通在信网关转发话单（MT-F）格式41A.5用户计费类别43附录B（规范性附录）中国联通联通在信网关联网协议（SGIP1.3）44 B.1通信方式44B.1.1消息从本地SMSC到本地SP44B.1.2消息从本地SP到本地SMSC44B.1.3消息从本地SMSC到异地SP44B.1.4消息从本地SP到异地SMSC45B.1.5路由选择45B.2通信流程45B.2.1专用SGIP方式45B.2.2通用HTTP方式45B.2.3通信节点编号规则45B.2.4序列号的定义45B.2.5通信安全46B.2.6SP与SMG的通信46B.2.6.1通用HTTP方式46B.2.6.1.1从SP到SMG的命令46 B.2.6.1.2从SMG到SP的命令46 B.2.6.2专用SGIP方式47B.2.6.2.1通信初始化47B.2.6.2.2通信过程47B.2.6.2.3通信结束48B.2.6.2.4故障处理48B.2.6.2.5从SP到SMG的消息48 B.2.6.2.6从SMG到SP的消息48 B.2.7SMG与SMG之间的通信49 B.2.7.1痛信初始化49B.2.7.2通信过程49B.2.7.3通信结束49B.2.7.4故障处理49B.2.7.5SMG之间的消息49B.2.8SMG与GNS之间的通信50 B.2.8.1通信初始化50B.2.8.2通信过程50B.2.8.3故障处理50B.2.8.4从SMG到GNS的消息50 B.2.8.5从GNS到SMG的消息50 B.3消息定义51B.3.1基于通用HTTP的消息定义51 B.3.1.1Submit操作51B.3.1.1.1Submit命令的请求内容51 B.3.1.1.2Submit命令的应答内容53 B.3.1.2Deliver操作53B.3.1.2.1Deliver命令的请求内容53 B.3.1.2.2Deliver命令的应答内容54 B.3.1.3Report操作54B.3.1.3.1Report命令的请求内容54 B.3.1.3.2Report命令的应答内容55 B.3.1.4UserRpt操作55B.3.1.4.1UserRpt命令的请求内容55 B.3.1.4.2UserRpt命令的应答内容55B.3.1.5Trace操作55B.3.1.5.1Trace命令的请求内容55 B.3.1.5.2Trace命令的应答内容55 B.3.2基于专用SGIP的消息定义56 B.3.2.1数据类型56B.3.2.2消息头格式56B.3.2.3消息体格式56B.3.2.3.1Bind操作56B.3.2.3.2Unbind操作57B.3.2.3.3Submit操作57B.3.2.3.4Deliver操作59B.3.2.3.5Report操作60B.3.2.3.6AddSP操作61B.3.2.3.7ModifySP操作61B.3.2.3.8DeleteSP操作61B.3.2.3.9QueryRoute操作62 B.3.2.3.10AddTeleSeg操作63 B.3.2.3.11ModifyTeleSeg操作63 B.3.2.3.12DeleteTeleSeg操作63 B.3.2.3.13AddSMG操作64B.3.2.3.14ModifySMG操作64 B.3.2.3.15DeleteSMG操作64B.3.3测试消息6510.1.2Trace命令的语法6510.1.3Trace_Resp应答的语法6511常量定义6511.1消息ID定义6511.2错误码定义6611.3计费类别定义6811.4Report状态与短消息状态的映射68附录C（规范性附录）中国联通SP管理系统业务鉴权协议（SPAPV1.0）69 C.1概述69C.1.1协议说明69C.1.2适用范围69C.2通信流程69C.3连接方式69C.4消息定义69C.4.1SPAP通讯协议描述69C.4.2消息ID定义69C.4.3通讯流程模型70C.4.4包头定义70C.4.4.1包头序列号规则70C.4.4.2SGIP协议中LinkID的生成规则71C.4.5包体定义71C.4.5.1请求连接包Auc_Bind71C.4.5.2请求连接包应答Auc_Bind_Resp71C.4.5.3业务鉴权包AUC71C.4.5.4业务鉴权包应答AUC_Resp72C.4.5.5对SP的通知包Noti_ToSP72C.4.5.6对SP通知包应答Noti_ToSP_Resp72C.4.5.7对用户的通知包Noti_ToUser72C.4.5.8对用户的通知包应答Noti_ToUser_Resp72C.4.5.9链路检测包KeepAlive与KeepAlive_Resp73C.5错误定义表73附录D（规范性附录）SP网站点播、定制、退定业务接口74 D.1接口规范75D.2加密算法示例76附录E（规范性附录）在信网关与短信中心状态报告接口76前言随着短消息业务的蓬勃发展，中国联通建设了GSM短消息中心、联通在信网关、互通网关等一系列短消息网络实体，以便于开展业务。
数字网址业务SP使用手册
中国联通数字网址业务SP使用手册V1.0中国联合通信有限公司二零零四年四月目录1.总则 (3)1.1.背景 (3)1.2.文档内容 (3)1.3.适用范围 (3)1.4.解释权及修订权 (3)1.5.术语与缩略语 (3)1.6.参考文献 (4)2.数字网址业务 (4)2.1.概念 (4)2.2.管理 (4)2.3.类型 (5)3.数字网址业务的申请 (5)3.1.SP数字网址的申请 (5)3.2.申请频道数字网址 (8)3.3.修改数字网址 (8)3.4.暂停数字网址 (8)1. 总则1.1. 背景随着“联通无限”的正式推出，中国联通各项数据增值业务得到了长足的发展，本着与中国移动展开差异化竞争的策略，联通充分发挥CDMA 1X在技术上资源利用率高，上网速度快的优势，在WAP、彩E、Brew、Java、定位、上网卡等项业务中占得了先机。
随着移动数据增值业务的蓬勃发展，用户对增值业务也提出了越来越多的要求。
如何进一步提高终端的易用性，改善用户的使用体验，解决不断增加的业务与终端支持之间的矛盾已经逐渐成为用户的迫切要求。
为此中国联通公司即将推出“数字网址”业务，在以上方面满足了用户的需要。
1.2. 文档内容本文档主要说明了SP申请及使用中国联通数字网址业务的管理办法。
1.3. 适用范围本文档适用于所有希望开通数字网址业务的CP/SP。
1.4. 解释权及修订权本文由中国联通制定、审核并发布，起草单位为中国联通增值业务部。
本文将根据市场发展需要适时进行修改，其修改权和解释权属于中国联通增值业务部。
1.5. 声明目前，数字网址的使用仅限于试用阶段，现在CP/SP使用的数字网址将会根据使用情况进行调整，试用期结束后，联通公司另行通知相关管理规定。
1.6. 术语与缩略语1.7. 参考文献1)《中国联合通信有限公司数字网址业务规范》2)《中国联合通信有限公司数字网址业务管理办法》2. 数字网址业务2.1. 概念数字网址业务是中国联通公司为满足移动数据业务的发展，改善终端用户的体验推出的新业务。
SP接入API使用指南
SP接入API使用指南版本：1.2深圳市傲天信息技术有限公司深圳市高新科技园南区科技南十路深圳国际技术创新研究院二楼A座邮政编码：518057电话：86-755- 26727239第一章概述 (3)1.1 系统简介 (3)1.2 系统设计原则 (3)1.3 术语说明 (4)第二章系统结构 (4)2.1 结构说明 (4)2.2 系统结构图 (4)2.3 系统应用环境 (5)2.4 系统开发环境 (5)第三章接口函数说明 (6)3.1 函数说明格式 (6)3.2 数据结构定义 (6)3.2.1 Deliver包结构 (6)3.2.2 Report包结构 (6)3.2.3 MT Response结构 (7)3.2.4 Submit错误结构 (7)3.3 函数功能介绍 (8)3.3.1 Startup（系统初始化函数） (8)3.3.2 Submit（下发消息函数） (9)3.3.3 Deliver（Deliver包处理函数） (11)3.3.4 Report（Report包处理函数） (11)3.3.5 MT Response（MT Response包处理函数） (12)3.3.6取包函数 (12)第一章概述本章首先简要介绍了傲天公司的短信网关平台（MUSE SMG），然后描述了API的设计目标及原则。
1.1 系统简介MUSE SMG（短信网关）为SP提供了一个具有全网互连功能的短消息接入平台，为电信运营商、SP开展全国性的短消息业务提供了承载功能，借助这个通道，SP可以向手机用户提供短消息增值服务。
随着短消息增值业务的不断发展，越来越多有着丰富特色的SP希望尽快接入到该平台上，为广大的手机用户提供各种应用，同时也使自己获得可观的利益。
由于SP与网关平台之间相连是采用SGIP协议来实现的，SP必须在熟悉SGIP协议的前提下才能进行开发，这样就增加了开发难度，也延长了SP接入的时间。
基于这种情况，傲天公司凭借自己在网关开发及协议理解方面的优势，开发了这套API。
联通在信接入注意事项V1.2
联通在信全网新增SP接入注意事项（Ver1.2）联通宽带在线有限公司增值业务测试部2009年3月目录第一部分资料提交 (1)第二部分网关连接 (5)第三部分业务流程 (8)第四部分业务实现 (11)附录集中网关常见错误代码表 (18)第一部分资料提交一、概述企业资料XML文档、业务资料TXT文档和SP服务器信息文档是SP 开展业务必要的技术文档。
中国联通在对SP合作资格与业务审核通过后，根据该文档进行业务数据导入。
虽然新增业务可以线上直接申报并生成业务资料TXT文档，但新接入的SP，部分资料仍需要手工填写，线下提交，因此须严格注意格式。
二、填写依据业务资料填写依据为：《中国联通全国性联通在信业务SP管理系统SP资料导入规范》三、SP管理系统对业务的处理要点1．业务类型1）每个业务必须申报，设定一个唯一的业务代码（计费代码），业务代码不区分大小写，全部转换为大写；2）订制类业务必须用户订制后才能给用户下行，业务开展中SP可在订制用户没有上行的情况下下行，订制类业务不允许第三方付费；3）点播类业务必须用户上行点播后才能下行，目前允许发送给第三方；4）仅0000和ERROR业务代码不需要申报，其他业务均需要申报，联通新时讯通信有限公司系统运行部 1目前只有点播（免费或按次计费）和包月订制两种类型，同一业务的不同类型分别申请业务代码。
2．命令字1）每个业务必须申报命令字，点播类申报一个或多个点播命令字，订制类申报一个订制命令字和一个退订命令字2）命令字只能包含a-z、A-Z、0-9和-_共64个字符，其他字符如空格和#等系统都认为是命令字的结束符3）每个SP的命令字不应重复，全部为大写，每个命令字只能属于一个业务3．长号码1）SP管理系统支持长号码的上下行，但SP申报业务时必须全以短号码申报，SP管理系统以短号码对上下行进行匹配2）点播业务如欲使用长号码，SPNUMBER字段填写短号码，但OperateDesc字段应对实际使用的长号码进行提示，使业务拨测能正确进行3）订制业务时的二次确认，用户收到的提示是发送命令字到短号码四、填写注意事项1。
中国联通 SGIP1.2 短消息网关开发接 口库说明书
中国联通SGIP1.2短消息网关开发接口库使用手册WritenBy：PrinceToadEmail:******************Version:1.0 2003/9/9DownLoad1. 接口说明该接口库是用VC6.0开发的基于Windows平台上的SGIP1.2协议的实现，接口对中国联通SGIP协议进行了高度封装，目的是方便SP接入中国联通短消息网关。
2.功能特点1) 严格按照SGIP1.2协议实现，支持Bind, BindResp,Submit, SubmitResp, Deliver,DeliverResp, Report, ReportResp, Unbind, UnbindResp消息。
2) 采用多线程并发处理的方式获取强大的性能，针对SGIP协议的特点，内建线程池进行消息的收发及处理操作，充分发挥系统和网络性能，再大的业务量也能够得到及时处理，丢包率小于0.01/%。
3) 发送消息采用短连接的方式；接收消息采用半长连接的方式，可以设置超时时间，在没有消息的情况下，主动断开网关连接。
4) 接口库经过高度封装，模块化强，使用简单，屏蔽了网关通信，消息收发和处理的复杂性操作，SP用户只需要关注具体的业务处理过程，大大简化了短消息开发的难度！3.接口函数该接口库以动态库的形式提供，包含以下三个文件：sgip.h, sgip.lib, SGIP.DLL.在动态库中导出了CSgip类，包含以下接口函数：2.1 Startint Start(char* sLocalIP, int nLocalPort, char* sPeerIP, int nPeerPort, char* sLoginName, char* sLoginPwd, int nConnType, char* sSrcNum, void (*PDeliver)(DeliverStr deliver), void (*PReport)(ReportStr report), void (*PResponse)(MTRespStr response), void (*PMTError)(MTErrorStr mterror))用于启动消息收发和处理线程池，连接监听线程，并且用提供的用户名和口令尝试登录网关。
短信网关SP端应用程序接口使用详细说明
⏹⏹短信网关SP端应用程序接口使用说明---- SXIT_ISMG_CMPP_API一、使用说明本接口遵循CMPPv2.0 协议标准，以提供消息发送与接收函数的方式，向SP 提供同移动网关进行信息交换的实现途径.客户能够根据具体需要，利用所提供的函数实现不一致的连接方式(长连接与短连接)与何时自动建立与中断连接，除此之外，API 作为应用的接口，对CMPP 描述的其它功能，象流量操纵、重发机制与并发处理都不预干预，需要应用程序处理。
二、函数说明：1、与网关建立连接(CMPP_Connect)◆函数功能与网关建立网络连接，返回值>0时，标识一个连接，在下列的函数中使用◆返回值>0 连接成功<0 连接失败◆参数说明：◆注意：username是接入局分配的接入用户名，而不是企业代码。
2、向网关提交信息(CMPP_Submit)◆函数功能向网关提交短信◆返回值=0 标识成功<0 标识发送失败◆参数说明：◆注意：假如建立好连接后一段时间没有发送消息，网关将关闭连接，CMPP_Submit返回ERROR_SOCKET_CLOSE ，这时，务必重新建立连接并发送消息3、查询网关（CMPP_Query）◆函数功能向网关提交查询包，并得到查询结果。
◆返回值=0 标识成功<0 标识失败◆参数说明：◆注意：username是接入局分配的接入用户名，而不是企业代码。
4、主动与网关断开连接◆函数功能主动与网关断开链接◆返回值=0 标识成功<0 标识失败◆参数说明：5、连接MO网关（CMPP_Connect_MO）◆函数功能连接MO虚拟链路到网关◆返回值>0 标识成功返回值标识一个连接，在下列的函数中使用<0 标识失败◆参数说明：◆参数说明：◆注意：username是接入局分配的接入用户名，而不是企业代码。
6、等待并接收MO 消息◆函数功能连接MO虚拟链路到网关◆返回值=0 标识成功返回值标识一个连接，在下列的函数中使用<0 标识失败◆参数说明：◆注意：假如没有MO消息将堵塞，直至MO消息到达或者连接被网关关闭7、删除短信（CMPP_Cancel）◆函数功能向网关提交查询包，并得到查询结果。
中国联通短信网关sgip 第三方 api(java)
标题/Title: SGIP API(JA V A) For SP 一. 目录二. 概述本文提供的API支持多个SP通过英斯克短信网关iDAP接入短信中心，向终端用户发送短消息。
SP 的应用程序需要遵循联通的SGIP1.1协议，调用iDAP的API实现短信发送和点播功能。
作为ISMG厂商，英斯克提供接入的Java API，本文解释了API中JA V A API的用法。
三. API文件说明提供给SP使用的API包名称为spApi.jar，它共包括以下类：SGIP_Command.class,Seq.class,MsgHead.class,Bind.class BindResp.class,Unbind.class,UnbindResp.class Submit.class,SubmitResp.class,Deliver.class,DeliverResp.class,Report.class,ReportResp.class,在使用此API 前,请正确地将包设置到CLASSPA TH环境变量中。
1.类SGIP_Command说明1.1.1构造函数1）public SGIP_Command()作用：构造函数，创建一个空的SGIP_Command对象1.1.2方法2）public SGIP_Command read(InputStream in)作用：接收任何来自网关的命令。
参数：InputStream in 输入流异常： IOException3）public int getCommandID()作用：获得读取的命令的代码返回值：命令代码4）示例：（具体示例见后面的完整程序）//接收sgip的消息…Socket so=null;OutputStream out=null;InputStream input=null;so=new Socket("192.168.0.30",8801);out=new DataOutputStream(so.getOutputStream());input = new DataInputStream(so.getInputStream());SGIP_Command sgip=new SGIP_Command();//创建一个空的SGIP_Command对象SGIP_Command tmp＝null；…tmp=sgip.read(input);// 接收sgip的消息…if(sgip.getCommandID()==SGIP_Command.ID_SGIP_BIND_RESP){resp=(BindResp)tmp;//强制转换resp.readbody();//解包System.out.println(tmp.getSeqno_1());System.out.println(tmp.getSeqno_2());System.out.println(tmp.getSeqno_3());System.out.println(resp.GetResult());}…2.类Bind （该类由SGIP_Command类扩展而来）1.1.3构造函数1) public Bind(int NodeID)作用：构造函数参数：NodeID节点编号,300000+CP_ID2) public Bind(int NodeID,int LoginType,String LoginName,String LoginPassword)作用：构造函数参数：NodeID, 节点编号LoginType,登录类型。
中国联通SGIP协议(v1.2)
中国联合通信公司短消息网关系统接口协议(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。
短信平台接入网关说明书及常见问题解答
短信平台接入网关说明书及常见问题解答一、网关介入说明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，短信平台必填项网关地址：电信运营商提供网关服务器访问地址“http://网关IP:网关端口”，短信平台必填项登录名称：电信运营商提供登录网关用户名，短信平台必填项登录密码：电信运营商提供登录网关密码，短信平台必填项服务代码：电信运营商提供服务代码，没有提供则为空产品代码：电信运营商提供产品代码，没有提供则为空回调地址：默认填写http://短信平台IP:8080/asp/sms/SmsWebService，短信平台必填项2.3 联通参数短信平台支持联通SGIP1.2协议，需要运营商提供参数如下：特服号码：12379，短信平台必填项企业代码：联通运营商提供企业id，短信平台必填项网关地址：联通运营商提供网关服务器ip地址，短信平台必填项网关端口：联通运营商提供网关服务器端口号，短信平台必填项登录名称：联通运营商提供登录网关用户名，短信平台必填项登录密码：联通运营商提供登录网关密码，短信平台必填项本地端口：短信平台自身提供，默认8801，短信平台必填项业务代码：联通电信运营商提供业务代码，没有提供则为空源节点ID：联通电信运营商提供源节点ID，没有默认填写02.4 配置参数短信平台支持5种协议，根据运营商提供的协议短信平台选择对应的协议，然后再进行每个协议的详细参数配置，参数配置完成点击“保存”按钮，在点击“停止”按钮，最后点击“启动”按钮，刷新当前页面查看状态指示灯是否为绿色，绿色代表短信平台与网关服务器联通。
中国联通短信网关SGIP 第三方 API(JAVA)
2. 类 Bind （该类由 SGIP_Command 类扩展而来）
LoginName, 服务器端给客户端分配的登录名 LoginPassword, 服务器端和 Login Name 对应的密码 1.1.4 方法 3) public void SetLoginType(int LoginType) 作用： 设置 LoginType 参数： int LoginType 4) public void SetLoginName(String LoginName) 作用： 设置 LoginName 参数： String LoginName 5) public void SetLoginPassword(String Password) 作用： 设置 Password 参数： String Password 6) public int write(OutputStream out) 作用： 发送命令 参数： OutputStream out,输出流
Confidential
Page 2
SGIP API(JAVA) for SP Product: iDAP
Document No.1.2 Date: Nov 25, 2001
INTRINSIC
Update:Zhang Feng,Zhao Jiang
resp=(BindResp)tmp;//强制转换 resp.readbody();//解包 System.out.println(tmp.getSeqno_1());
联通新SP接入指南
新SP接入指南
公司信息接入的流程如下一页：
新SP接入指南
新SP接入指南
业务信息接入的流程如下一页：
新SP接入指南
新SP接入指南
SP申请接入的业务类型后要等待联通管理员的审核。联通管理员对业务信息进行初审，初审中可以指定该SP是否对网络环境进行测试，如果需要那么SP在网络环境测试后要提交网络测试报告详见“辽宁联通SP管理系统二期用户手册_SP管理门户”文档中“2.3.1业务信息接入管理”。
新SP接入指南
新SP接入指南
新SP接入指南
产品信息接入的流程如下一页：
新SP接入指南
新SP接入指南
新SP接入指南
对于首次接入的SP要访问http://220.201.8.49/spportal ,注册SP登录账号
接SP接入指南
新SP接入指南
对于首次接入的SP在注册账号后访问http://220.201.8.49/spportal ,点击“用户登录”
登录界面
新SP接入指南
对于首次接入本系统的SP，在没有录入公司信息时，要先录入公司信息。公司信息填写详见“辽宁联通SP管理系统二期用户手册_SP管理门户”文档中“2.2.1公司信息接入管理”
新SP接入指南
新SP接入指南
对于首次接入本系统的SP，在公司信息初审通过后，要申请接入的业务类型。业务信息申请填写详见“辽宁联通SP管理系统二期用户手册_SP管理门户”文档中“2.3.1业务信息接入管理”
新SP接入指南
06-23中国联通短消息网关联网协议
QB/CU 25-2003中国联通短消息网关联网协议（SGIP V1.2）中国联通公司2003年2月发布前言近年来，短消息业务发展迅速。
目前联通大部分分公司已经设立短消息中心并已投入使用，但由于缺少业务种类，加上联通总部对此缺乏统一规划，长期以来经济效益不明显，增值业务开展较少；现有的网络架构、人员、管理、技术等资源在支持短消息数据业务快速发展以形成规模效益及在新的技术平台上开展无线数据业务等方面已成为主要瓶颈。
为了统一短消息业务应用提供商（ＳＰ）的接入，大力发展中国联通短消息服务，联通公司以现有短消息网络资源为基础构建短消息网关系统，对所有ＳＰ的接入接口、短消息网关之间的接口等进行统一的规范。
本协议主要是参考了国际上相关技术规定以及我国移动通信网络的实际业务和功能需要而制订的。
主要内容包括：系统体系结构，通信流程，消息定义，常量定义等。
本规范由中国联合通信有限公司技术部提出并归口本规范起草单位：中讯邮电咨询设计院本规范主要起草人：张范李海燕康建雄左丽李明铎张岩许建宏本规范的修改和解释权属于中国联通公司目录1.总则 (1)2.系统体系结构 (2)2.1 消息从本地SMSC到本地SP (3)2.2 消息从本地SP到本地SMSC (3)2.3 消息从本地SMSC到异地SP (3)2.4 消息从本地SP到异地SMSC (3)2.5 路由选择 (4)3.通信流程 (5)3.1专用SGIP方式 (5)3.2通用HTTP方式 (5)3.3通信节点编号规则 (6)3.4序列号的定义 (6)3.5通信的安全性 (7)3.6用户鉴权 (7)3.6.1被叫方付费 (7)3.6.2SP付费 (7)3.6.3第三方付费 (8)3.7SP与SMG的通信 (8)3.7.1通用HTTP方式 (8)3.7.1.1从SP到SMG的命令 (9)3.7.1.2从SMG到SP的命令 (9)3.7.2专用SGIP方式 (9)3.7.2.1通信初始化 (10)3.7.2.2通信过程 (10)3.7.2.3通信结束 (11)3.7.2.4故障处理 (12)3.7.2.5从SP到SMG的消息 (13)3.7.2.6从SMG到SP的消息 (13)3.8SMG与SMG之间的通信 (13)3.8.1通信初始化 (14)3.8.2通信过程 (14)3.8.3通信结束 (14)3.8.4故障处理 (14)3.8.5两个SMG之间的消息 (14)3.9SMG与GNS之间的通信 (15)3.9.1通信初始化 (15)3.9.2通信过程 (15)3.9.3通信结束 (15)3.9.4故障处理 (15)3.9.5从SMG到GNS的消息 (16)3.9.6从GNS到SMG的消息 (16)4.消息定义 (17)4.1基于通用HTTP的消息定义 (17)4.1.1Submit操作 (17)4.1.1.1Submit命令的请求内容 (17)4.1.1.2Submit命令的应答内容 (18)4.1.2Deliver操作 (19)4.1.2.1Deliver命令的请求内容 (19)4.1.2.2Deliver命令的应答内容 (19)4.1.3Report操作 (20)4.1.3.1Report命令的请求内容 (20)4.1.3.2Report命令的应答内容 (20)4.1.4UserRpt操作 (20)4.1.4.1UserRpt命令的请求内容 (21)4.1.4.2UserRpt命令的应答内容 (21)4.1.5Trace操作 (21)4.1.5.1Trace命令的请求内容 (21)4.1.5.2Trace命令的应答内容 (21)4.2基于专用SGIP的消息定义 (22)4.2.1数据类型 (22)4.2.2消息头的格式 (22)4.2.3消息体的格式 (23)4.2.3.1Bind操作 (23)4.2.3.2Unbind操作 (24)4.2.3.3Submit操作 (24)4.2.3.4Deliver操作 (26)4.2.3.5Report操作 (27)4.2.3.6AddSP操作 (28)4.2.3.7ModifySP操作 (28)4.2.3.8DeleteSP操作 (29)4.2.3.9QueryRoute操作 (30)4.2.3.10AddTeleSeg操作 (31)4.2.3.11ModifyTeleSeg操作 (31)4.2.3.12DeleteTeleSeg操作 (32)4.2.3.13AddSMG操作 (33)4.2.3.14ModifySMG操作 (33)4.2.3.15DeleteSMG操作 (34)4.3鉴权消息定义 (34)4.3.1CheckUser命令的语法 (35)4.3.2CheckUser_Resp应答的语法 (35)4.3.3UserRpt命令的语法 (35)4.3.4UserRpt_Resp应答的语法 (35)4.4测试消息定义 (35)4.4.1Trace命令的语法 (36)4.4.2Trace_Resp应答的语法 (36)5.常量定义 (37)5.1消息ID定义 (37)5.2错误码定义 (37)5.3计费类别定义 (38)5.4R EPORT 状态与短消息状态的映射 (38)附录1 缩略语 (39)附录2 全网路由表的格式示范 (40)附录3 本地路由表的格式示范 (41)附录4 HTTP承载方式示范 (42)附录5 引用标准 (44)1.总则本协议是SMG和SP之间、SMG和GNS之间、以及SMG和SMG之间的接口协议，简称SGIP。
中国联通短消息网关联网协议SGIPv12适应性修改版
“联通在信”SGIP1.2协议修改部分说明（修订版）中国联合通信公司2004年01月20日目录1. SGIP 1.2版的变化 (3)1.1. 新增字段 (3)1.2. SGIP协议变化部分 (3)1.2.1.Deliver包中的Reserve字段 (3)1.2.2.Submit中的Reserve字段 (3)1.2.3.Submit包的UserCount字段填写限制 (3)1.2.4.Submit包的MORelatetoMTFlag字段 (4)2. 业务逻辑变化部分 (4)2.1. 定制（订购）业务管理规范 (4)2.2. 点播类业务管理规范 (4)2.3. 对SP业务申报过程中业务类型的管理规范 (5)3. SP具体操作和修改部分 (7)3.1. Reserve字段的说明 (7)3.2. 对于短信上行MO的判断和MT处理 (7)3.3. 对于用户网上点播的判断和处理 (7)3.4. 对于非点播（定制命令）引起的MT (7)1.SGIP 1.2版的变化1.1.新增字段无。
1.2.S GIP协议变化部分1.2.1.Deliver包中的Reserve字段该Reserve字段为8个字节的保留字段；现将该字段作为MO和MT之间一一对应的LinkID来用。
该Reserve的值（LinkID）由SPMS业务鉴权平台生成，传给SPSMG，由SPSMG 不做任何改动传给SP。
用来标识点播的MO消息，使得MT（如果MO引起多条MT ,则每条MT都要将MO中的Reserve中的值取出，赋值到Submit包中的Reserve）消息能够匹配对应的MO消息；非MO所引起的MT，SP不填写该LinkID。
1.2.2.Submit中的Reserve字段该Reserve字段为8个字节的保留字段；现将该字段作为MO和MT之间一一对应的LinkID来用。
该Reserve字段的值（LinkID）由SPMS业务鉴权平台生成，传给SPSMG。
短信业务网关功能说明书
短信业务网关功能说明书目录短信业务网关功能说明书 (1)一、接口类功能 (2)1.1短信发送 (2)1.2短信查收 (3)1.3部门同步 (3)1.4用户同步 (3)二、业务类功能 (4)2.1短信收发 (4)2.2短信订阅 (4)2.3并发限速及分流控制 (4)2.4短信重发机制 (5)三、管理类功能 (5)3.1、短信业务管理功能 (5)3.2、短信业务报表 (6)3.3、短信过滤机制 (6)3.4、运行监控机制 (6)3.5、日志记录功能 (6)为了满足高性能、易管理、可扩展的业务需求，短信业务网关功能采用基于B/S结构的架构方式。
支持SMPP、CMPP、SGIP、CNGP等协议，支持移动、电信、联通、小灵通用户短信收发，达到了每秒100条的发送速度。
在结构上主要由以下三个部分组成：接口类功能、业务类功能、管理类功能组成(见图1)。
【图1】一、接口类功能第三方接口提供多语言SDK支持，如Java、C#、C++等，提供的接口包括：短信发送、短信查收、部门同步、用户同步，方便第三方软件整合短信网关功能。
1.1短信发送支持短信单一发送和群发，每次群发上限为100人。
如果短信内容超出70个字条，则自动分拆成多条发送，短信发送后返回发送结果，如果发送失败则返回失败原因，如：系统超时、短信被过滤等。
图21.2短信查收根据固定号码接收短信，短信内容包括，发送人、发送时间等信息，暂不支持彩信。
1.3部门同步通过部门同步接口可以定时同步联信通的部门数据实现可视化的短信报表功能。
提供的部门信息包括：部门ID，部门名，上级部门，排序、部门负责人等字段。
1.4用户同步通过用户同步接口可以定时同步联信通的用户数据实现可视化的短信报表功能。
提供的用户信息包括：用户ID，用户名，所属部门，排序等字段。
二、业务类功能业务类功能主要包括：短信收发、短信订阅、并发限速及分流控制、短信重发机制。
2.1短信收发短信收发是短信网关提供的基本功能，支持计算机到手机，手机到计算机的短信互发。
联通接收发送程序配置说明文档
将程序Submit.exe（Deliver.exe）及配置文件SGIP12.ini拷贝到指定目录，按照如下说明配置参数即可正常运行该程序。
// 以下为参数配置项[Option]// 此处设定中国联通网关的IP地址;网关IP地址IP = 127.0.0.1// 此处设置中国联通网关接收Socket数据的监听端口，用以接收提交到短信网关的数据;远程发送短信网关端口ClientPORT = 8801// 此处设置中国联通短信接收程序本地的监听端口，用以接收状态报告和上行信息;本地接收短信网关端口ServerPORT = 8802// 中国联通接收发送程序对应的短信接收发送端口;SP接入号SPCode = 10658// 中国联通接入SP的企业代码;SP企业代码SPCorpID = 90123// 登录中国联通网关的该SP的用户名;登陆网关的用户名User = test// 登录中国联通网关的该SP的用户密码;登陆网关的口令Password = test// 登录中国联通网关的该SP的节点号;节点号NodId = 3311090123// 程序每次从数据库Select获取记录之间的间隔时间，增大该值可以减轻CPU空闲时负担，但降低程序运行效率;发送短信时间间隔(单位毫秒)DelayTime = 50// 程序每次从数据库Select获取的记录条数，当表中数据小于该数时，获取全部记录;每次轮询数据库获取记录上限MaxRecCount = 500// 当数据库表中没有可发送的数据记录时，数据库的轮询检测时间间隔，增大该值可以减轻CPU空闲时负担，但降低程序运行效率;轮循数据库读取发送队列时间间隔(单位毫秒)LoopTime = 50// 清空主界面中列表框信息的触发数量，当达到指定条数时自动清空列表减少内存占用;执行清空信息框条件的触发行数ClearInfoLineCount = 500// 是否进行日志的记录操作，如果需要记录日志，该参数设定为1，否则设置为0;是否记录日志(0不记录, 1记录)CanWriteLog = 0// 数据库参数配置Provider=SQLOLEDB.1; 数据库连接类型Data Source=127.0.0.1; 数据库服务器IP地址Initial Catalog=testdb; 数据库名称User ID=sa; 数据库用户名Password=sa; 数据库用户密码;数据库连接字符串AdoConn=Provider=SQLOLEDB.1;Data Source=127.0.0.1;Initial Catalog=testdb;User ID=sa;Password=sa;// 启动接收发送程序的并发数量（若启动程序的并发数量为5，则五个接收发送的编号依次为0、1、2、3、4）;数据库访问索引数量TotalIndex = 1// 启动接收发送程序的当前编号（若启动程序的并发数量为5，则五个接收发送的编号依次为0、1、2、3、4）;数据库访问索引号码SelectIndex = 0。
中国联合通信公司短消息网关系统接口协议(SGIP1
中国联合通信公司短消息网关系统接口协议（SＧIＰ）版本1.2中国联合通信公司二零零一年十月目录1概述ﻩ错误!未定义书签。
1.1协议说明ﻩ错误!未定义书签。
1.２适用范围............................................................................. 错误!未定义书签。
1．3参考资料............................................................................ 错误!未定义书签。
1．4术语表ﻩ错误!未定义书签。
2系统体系结构ﻩ错误!未定义书签。
２.1消息从本地SMＳC到本地SＰﻩ错误!未定义书签。
２.2消息从本地SＰ到本地ＳMSＣ......................................... 错误!未定义书签。
2．3消息从本地ＳMSC到异地SPﻩ错误!未定义书签。
2．4消息从本地ＳP到异地SMＳCﻩ错误!未定义书签。
2.5路由选择 (3)3ﻩ通信流程ﻩ错误!未定义书签。
3.１专用SGＩＰ方式 ............................................................... 错误!未定义书签。
３．2通用HTTＰ方式. (5)3.３通信节点编号规则ﻩ错误!未定义书签。
3.4序列号的定义....................................................................... 错误!未定义书签。
3.５通信的安全性ﻩ错误!未定义书签。
3．6用户鉴权............................................................................ 错误!未定义书签。
3.6.１被叫方付费ﻩ错误!未定义书签。
中国联通CPSP接口规范
中国联通CP/SP接口规范微软（中国）有限公司2007年10月目录1 CP/SP业务定制/退定消息通知接口1.1 接口描述用于综合管理平台将用户定制/退定业务通知给相应的CP/SP。
当用户通过中国联通综合增值业务管理平台上定制或者退定CP/SP的某一个业务时，中国联通综合增值业务管理平台将准实时（10分钟）通知CP/SP的应用服务器该用户的定制或者退定信息。
其中中国联通综合增值业务管理平台需要负责提供CP/SP在平台中的代码，以及CP/SP的各业务代码；CP/SP需要提供执行该接口功能的URL。
1.2 发起方总部综合管理平台1.3 接收方CP/SP业务系统1.4 接口方式HTTP POST1.5 接口内容本接口为POST消息，消息的格式为标准XML格式。
1.5.1 定制服务请求（综合管理平台发起）：响应（CP/SP收到请求后的回应）：1.5.2 退定服务请求（综合管理平台发起）：响应（CP/SP收到请求后的回应）：请求元素说明：1． cpcode value：表示CP/SP在中国联通VASP平台中的代码。
2． userid value：用户11位手机号码，如果加密，则为27位加密字符串。
3． encryptflag value：手机号码是否加密，取值’Y’或者’N’。
4． serviceid value：表示CP/SP在中国联通VASP平台中的业务代码。
5． Productid value：表示用户具体订购和退订的某一服务下的具体产品代码6． Ispack value：表示以上产品是否属于优惠套餐，取值’Y’或者’N’。
7． sub_type value：表示用户定制或者退定的是哪种计费方法，MONTH表示包月计费，PER_HIT表示按次计费，DAY表示包天计费，FREE表示免费。
8． orderdate value：表示定制时间，格式为’yyyy-MM-dd HH:mm:ss’，例如’2007-10-22 18:45:34’。
SP接入API使用指南
SP接入API使用指南版本：1.2深圳市傲天信息技术有限公司深圳市高新科技园南区科技南十路深圳国际技术创新研究院二楼A座邮政编码：518057电话：86-755- 26727239第一章概述 (3)1.1 系统简介 (3)1.2 系统设计原则 (3)1.3 术语说明 (4)第二章系统结构 (4)2.1 结构说明 (4)2.2 系统结构图 (4)2.3 系统应用环境 (5)2.4 系统开发环境 (5)第三章接口函数说明 (6)3.1 函数说明格式 (6)3.2 数据结构定义 (6)3.2.1 Deliver包结构 (6)3.2.2 Report包结构 (6)3.2.3 MT Response结构 (7)3.2.4 Submit错误结构 (7)3.3 函数功能介绍 (8)3.3.1 Startup（系统初始化函数） (8)3.3.2 Submit（下发消息函数） (9)3.3.3 Deliver（Deliver包处理函数） (11)3.3.4 Report（Report包处理函数） (11)3.3.5 MT Response（MT Response包处理函数） (12)3.3.6取包函数 (12)第一章概述本章首先简要介绍了傲天公司的短信网关平台（MUSE SMG），然后描述了API的设计目标及原则。
1.1 系统简介MUSE SMG（短信网关）为SP提供了一个具有全网互连功能的短消息接入平台，为电信运营商、SP开展全国性的短消息业务提供了承载功能，借助这个通道，SP可以向手机用户提供短消息增值服务。
随着短消息增值业务的不断发展，越来越多有着丰富特色的SP希望尽快接入到该平台上，为广大的手机用户提供各种应用，同时也使自己获得可观的利益。
由于SP与网关平台之间相连是采用SGIP协议来实现的，SP必须在熟悉SGIP协议的前提下才能进行开发，这样就增加了开发难度，也延长了SP接入的时间。
基于这种情况，傲天公司凭借自己在网关开发及协议理解方面的优势，开发了这套API。
短消息网关客户端开发包使用详细说明
技术文件技术文件名称：短消息网关客户端开发包使用详细说明技术文件编号：版本：文件质量等级：共10页拟制审核会签标准化批准深圳市中兴通讯股份有限公司目录1功能说明 (3)2安装 (3)3目录结构 (3)4接口函数功能说明 (4)4.1 初始化API函数 (4)4.2 发送和接收函数 (4)4.2.1发送1 条短信 (4)4.2.2群发短信 (4)4.2.3获取群发短信结果 (4)4.2.4接收短信 (4)4.2.5设置参数函数 (5)4.3 查询和测试函数 (5)4.3.1检查短信网关是否能够提供服务 (5)4.3.2查询短消息信息 (5)5函数参数和数据结构说明 (5)5.1 初始化API函数 (5)5.2 发送一条短消息 (5)5.3 群发短消息 (6)5.4 获取群发短信结果 (7)5.5 接收短信 (7)5.6 设置参数函数 (8)6配置参数说明 (8)7短信的自动分割功能 (9)8编译说明 (9)8.1 UINX平台 (9)8.2 WINDOWS平台 (9)9网关客户端开发包支持的平台 (9)10例子程序说明 (10)10.1 简单测试程序 (10)10.2 综合测试程序 (10)11错误代码 (10)12其它说明 (10)短消息网关客户端开发包使用详细说明1功能说明短消息网关客户端开发包的主要功能是：为ICP(SP)应用提供标准的API接口，通过该接口,ICP可以基于SMGP协议和短消息网关SMGW通讯。
该开发包具有以下特点。
[1]与SMGW通讯既支持短连接方式也支持长连接方式；[2]支持SMGP协议；[3]参数配置功能；[4]友好的参数接口。
2安装[1]把SMGP API 软件包解压到一个目录。
[2]修改../ SmGw_Client_API /config/smgpc.ini ，修改IcpId （ICP 编号）、IcpShareKey （ICP密码，缺省是123456789）、ClientIP （客户主机的IP 地址）和ServerIP （短信网关地址）。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
短信网关SP端应用程序接口使用说明
---- ZTE_SGIP_API
一、使用说明
本接口遵循SGIPv1.2 协议标准,以提供消息发送和接收函数的方式, 向ICP 提
供同联通网关进行信息交换的实现途径.客户可以依据具体需要,利用所提供的函数实现不同的连接方式(长连接和短连接)以及何时自动建立和中断连接, 除此之外, API 作为应用的接口,对SGIP 描述的其它功能,象流量控制重发机制和并发处理都不预干预,需要应用程序处理
二、函数说明：
1、设置源节点代码(set_src_node)
◆函数功能
依照SGIP1.2协议，设置源节点代码
◆返回值
无
◆参数说明：
2、与网关建立连接（SGIP_Connect）
◆函数功能
建立与网关间的连接
◆返回值
整型
>0 连接成功返回值标识一个连接，在以下的函数中使用
<0 连接失败
◆参数说明：
3、向网关提交信息(SGIP_Submit)
◆函数功能
向网关提交短信
◆返回值
=0 标识成功
<0 标识发送失败
◆参数说明：
1、如果建立好连接后一段时间没有发送消息，网关可能会关闭连接，
2、SGIP_Submit返回ERROR_SOCKET_CLOSE ,这时，必须重新建立连接并发送消息
3、p_seq1,p_seq2,p_seq3是函数返回的序列号，可与状态报告中的序列号对应
4、主动与网关断开连接（SGIP_Disconnect）
◆函数功能
主动和网关断开链接
◆返回值
=0 标识成功
<0 标识失败
◆参数说明：
5、等待并接收MO 消息（SGIP_Get_MO）
◆函数功能
等待并接收MO 消息
◆返回值
>0 标识成功收到MO消息,返回值是消息类型可能为MO_MSG或MO_REPORT
<0 标识发生错误:
◆参数说明：
◆注意：
1、应用程序必须自己建立监听socket,并将accept返回的socket标识传给SGIP_Get_MO
(参见test_mo例子)
2、如果没有MO消息将阻塞，直至MO消息到达或连接被网关关闭
3、返回ERROR_SOCKET_CLOSE并不是错误，只是网关关闭了连接
4、对收到的MO，应用程序要根据SGIP_Get_MO返回的类型。
三、结构体说明
1、MO消息
2、状态报告
四、常量说明
五、常见问题解答
1、为何联接到网关时网关回复ERROR_SOCKET_READ错误码？
答：造成此问题的原因很可能是你的IP同局方管理人员设置的IP不一致。
请与局方管理人员核对数据。
2、为何向网关提交短信时会返回ERROR_FEE_CODE错误码？
答：深讯信科网关要求资费类别为按条计费时资费代码不能为0；
3、接收MO消息时，为何进程会僵死？
答：造成此现象的原因很可能是api没有得到网关发来的MO或者状态报告包，处于阻塞等待状态。
4、为何和网关建立的MT链路经常会断开？
答：造成此问题的原因很可能是提交速度过快，以至超过网络的传输速度从而造成了网络阻塞。
六、Sp与网关间交易的基本流程
1、发送短信
2、接收短信。