联通短信网关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、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 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、接收短信。