sp接入api使用指南

《sp接入api使用指南》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、SP接入API使用指南-12SP接入API使用指南版本：1.2文档提交日：2002年06月25日最后修改日期：2002年09月09日深圳市傲天信息技术有限公司深圳市高新科技园南区科技南十路深圳国际技术创新研究院二楼A座邮政编码：518057电话：86-755-26727239本文档描述了SP接入API的使用说明，供使用人员参考。SP接入API使用指南-12第一章概述21.1系统简介21.2系统设计原则31.3术语说明3第二章系统结构42.1结构说明42.2系统结构图42.3系统应用环境52.4系统开发环境5第三章接口函数说明63.1函数说明格式63.2数据结构定义63

2、.2.1Deliver包结构63.2.2Report包结构63.2.3MTResponse结构73.2.4Submit错误结构73.3函数功能介绍83.3.1Startup（系统初始化函数）83.3.2Submit（下发消息函数）93.3.3Deliver（Deliver包处理函数）113.3.4Report（Report包处理函数）113.3.5MTResponse（MTResponse包处理函数）113.3.6取包函数12SP接入API使用指南-12第一章概述本章首先简要介绍了傲天公司的短信网关平台（MUSESMG），然后描述了API的设计目标及原则。1.1系统简

3、介MUSESMG（短信网关）为SP提供了一个具有全网互连功能的短消息接入平台，为电信运营商、SP开展全国性的短消息业务提供了承载功能，借助这个通道，SP可以向手机用户提供短消息增值服务。随着短消息增值业务的不断发展，越来越多有着丰富特色的SP希望尽快接入到该平台上，为广大的手机用户提供各种应用，同时也使自己获得可观的利益。由于SP与网关平台之间相连是采用SGIP协议来实现的，SP必须在熟悉SGIP协议的前提下才能进行开发，这样就增加了开发难度，也延长了SP接入的时间。基于这种情况，傲天公司凭借自己在网关开发及协议理解方面的优势，开发了这套API。通过使用API，SP在

4、不熟悉协议的情况下也可以快速的开发自己的服务程序，将更多的精力放在自己的业务流程处理上，从而在短时间内创造效益。1.2系统设计原则l模块化系统的功能设计按流程的要求实行模块化，以利于系统的开发和对系统的理解、使用。l稳定性性能稳定，能满足每秒发送/接受100条短信的要求。l灵活性系统结构应具有伸缩性，配置灵活。l实用性系统应处理好网络连接及协议封装，做到与业务无关。SP接入API使用指南-121.3术语说明SPServiceProvider，内容提供商SMGShortMessageGateway，联通管理人员的短消息网关，SMG之间的通讯协议采用SGIPSGIPSho

5、rtMessageGatewayInterfaceProtocol，本协议所描述的短消息网关接口协议，用于完成在SMG和SP之间、SMG和SMG之间短消息的发送、接收和转发功能，以及SMG和GNS之间路由表的同步功能SMSCShortMessageServiceCenter，短消息中心MO由手机用户提交的短消息MT由手机用户接收的短消息DeliverSMG用Deliver命令向SP发送MO消息SubmitSP用Submit命令向SMG提交MT消息ReportReport命令用于向SP发送一条先前的Submit命令的当前状态，或者用于向前转SMG发送一条先前的Deliv

6、er命令的当前状态第一章系统结构本章描述了API内部的结构及应用、开发环境。2.1结构说明系统采用事件驱动的方式工作，当调用初始化函数Startup后，一系列线程组件开始运行，包括Submit发送线程、连接监听线程、Deliver接收和处理线程等。当SP调用Submit函数时，Submit处理线程会自动生成Submit协议包并将该包发送给网关系统，同时接收网关返回的SubmitResponse，如果用户定义了Response处理函数，则触发Response事件，调用该函数。当收到网关的Deliver或Report时，Deliver处理线程会自动触发相应事件，调用用户定

7、义的业务处理函数。2.2系统结构图SP接入API使用指南-122.3系统应用环境适用操作系统：Windows98/NT/2000适用开发工具：VC5.0/6.0;VB6.0;C++Builder5.0/6.0;Delphi5.0/6.02.4系统开发环境操作系统：Windows2000开发工具：C++Builder6.0SP接入API使用指南-12第一章接口函数说明3.1函数说明格式每个函数按以下顺序进行介绍：【函数功能】：简要介绍函数所实现的功能。【函数原型】：给出该函数的标准C语言原型【参数说明】：给出每个参数的简要说明及输入、输出。【使用说明】