中国联合通信公司第1页“联通在信”SGIP1.2协议修改部分说明(修订版)中国联合通信公司2004年01月20日中国联合通信公司第2页目录1.SGIP1.2版的变化....................................................................................................31.1.新增字段.........................................................................................................31.2.SGIP协议变化部分.......................................................................................31.2.1.Deliver包中的Reserve字段.............................................................31.2.2.Submit中的Reserve字段..................................................................31.2.3.Submit包的UserCount字段填写限制............................................31.2.4.Submit包的MORelatetoMTFlag字段............................................42.业务逻辑变化部分....................................................................................................42.1.定制(订购)业务管理规范.........................................................................42.2.点播类业务管理规范.....................................................................................42.3.对SP业务申报过程中业务类型的管理规范...............................................53.SP具体操作和修改部分..........................................................................................73.1.Reserve字段的说明.......................................................................................73.2.对于短信上行MO的判断和MT处理.........................................................73.3.对于用户网上点播的判断和处理.................................................................73.4.对于非点播(定制命令)引起的MT..........................................................7中国联合通信公司第3页1.SGIP1.2版的变化1.1.新增字段无。1.2.SGIP协议变化部分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。SPMS将对MO所引起的下发MT进行Reserve(LinkID)值的匹配校验。1.2.3.Submit包的UserCount字段填写限制该字段,SP下发时必须填写1;否则视为业务非法包处理。中国联合通信公司第4页1.2.4.Submit包的MORelatetoMTFlag字段限制SP不能对该字段填写3(等于3表示系统反馈包,免通信费和信息费),防止违规利用该字段,进行未经许可的短信业务广告。SP用来进行业务宣传中国联通将提供专用通道(SP进行业务宣传和业务广告必须先登记,并通过中国联通增值业务部审核后,才能下发)。2.业务逻辑变化部分2.1.定制(订购)业务管理规范实施SPMS系统后,凡是订购(定制)业务都需要SPMS给用户发送确认短信,得到用户确认后,才形成临时订购关系;当SPMS短信通知SP成功后(业务定制),才将用户的临时订购(定制)关系改为正式订购(定制)关系。订购方式包括:用户发送MO短信到SP进行订购(定制)用户发送MO短信到SPMS的短信门户进行订购(定制)用户在SP网站上进行订购(定制)用户在SPMS的WEB门户上进行订购(定制)2.2.点播类业务管理规范对于点播业务,SPMS系统生成LinkID,形成点播MO和MT之间的对应关系。点播方式包括:用户发送短信MO进行点播(由SPMS生成LinkID,SP下发MT时要从MO的Reserve中拷贝,并在MT包中的Reserve按原值返回)用户在SP网站上进行点播时,SP调用SPMS提供的WEB点播调用接口,然中国联合通信公司第5页后由SPMS的给用户发送点播确认码,用户在SP点播界面输入该点播确认码,作为LinkID;SP将LinkID拷贝到点播所引起的MT的Reserved字段中后进行下发,SPMS对该Reserve进行校验,确认点播是用户操作行为。(SPMS的生成LinkID和图片给SP,SP将网上点播下发的MT包中,将“LinkID+图片中的数字”进行组合,填入到MT的Reserve中后,下发;SPMS对该Reserve进行校验,确认点播是用户操作行为,而不是SP违规下发)。2.3.对SP业务申报过程中业务类型的管理规范SP在申报业务的时候,对于定制类业务,要分别提供定制操作命令、退订操作命令、业务包这三种类型的业务类型代码(ServiceType);从而实现对用户订购关系的清晰管理。业务管理上,不允许出现订购/退订命令(MO)所对应的MT的ServiceType与业务包(MT)所对应的ServiceType相同的情况。目前决大多数SP这三种类型包(MT)的业务类型代码(ServiceType都是一样),SPMS管理系统在业务管理上无法区分是定制命令操作引起的MT包还是正常业务的MT包。修改示例(以SOHU为例):原来的业务情况列表:1.体育新闻业务名称操作业务代码指令格式(使用方法)发送频率(每日几次/每次几条)资费标准计费方式操作说明体育新闻XWTY平均5条/天20元/月MT让您在第一时间内了解体坛发生的每一个精彩瞬间,与您心中的明星同时感受胜利喜悦和失败忧伤。中国联合通信公司第6页体育新闻点播TYXWDDTY3条/次0.15元/条MT取消定制QTY此操作不收费修改后的方式:1.体育新闻业务名称操作业务代码指令格式(使用方法)发送频率(每日几次/每次几条)资费标准计费方式操作说明体育新闻XWTY平均5条/天20元/月MT让您在第一时间内了解体坛发生的每一个精彩瞬间,与您心中的明星同时感受胜利喜悦和失败忧伤。体育新闻点播TYXWDDTY3条/次0.15元/条MT定制XWTYTYDZ此操作不收费(体育新闻定制包月)取消定制XWTYQTY此操作不收费总结:SP要规范的部分用蓝色题字已经表示出,SP在生成现有定制用户文件时,必须要带上业务代码。某个业务的定制和退订的业务代码必须一致,不同的命令字,这样才能做到定制和取消这一对操作匹配。中国联合通信公司第7页3.SP具体操作和修改部分3.1.Reserve字段的说明Reserve保存的值是LinkID,一共8个字节,存放在SGIP协议的MO或MT中Reserve字段中。3.2.对于短信上行MO的判断和该MO引起的MT处理SP收到SPSMG网关发送的MO包后,要将MO中的Reserve字段原封不动拷贝出,并赋到该MO所引起的MT(1个或多个)包的Reserve字段中。该操作适用于进行定制命令、退订命令、MO所引起的MT点播之间的对应关系。如果SP不填,SPMS将因为匹配关系不合法,进行过滤。3.3.对于用户网上点播的判断和处理用户在网上点播,SPMS的WEB系统将传给SP两个部分的值(1个是MAPID,另一个是隐藏在图片内容中的图片随机码);SP要将MAPID(前4个字节)和图片随机码(后4个字节)当成Inter进行内存拷贝到Reserve的8个字节中,作为LinkID。用户在SP网站上进行点播,SPMS的给用户发送点播确认码,用户在SP点播界面输入该点播确认码,作为LinkID;SP将LinkID拷贝到点播所引起的MT的Reserve字段中后进行下发,SPMS对该Reserve进行校验,确认点播是用户操作行为。3.4.对于非点播(定制命令)引起的MT对于非短信MO所引起的MT,SP对该MT的Reserve字段填写数字0。中国联合通信公司第8页特别说明:月租鉴权包在业务上属于非点播引起的MT。3.5.SP网站上定制–网上定制用户在SP网上定制,SP调用SPMS提供的定制接口。SPMS向用户发送定制确认短信,得到用户的确认后,才形成定制关系,然后向SP发送(模拟用户)定制短信,SP此时才能确认并生成用户与业务的定制关系。4.对于定制包月计费短信的处理对于SP定期下发的包月话费短信的包的填写格式不变,采用如下流程:1)SP下发定制包月计费短信后,由集中网关SPSMG发送给SPMS进行用户鉴权。2)一个业务一条短信。SP下发包月计费短信的内容格式要求如下:您已订阅AAAAAA(CCCC)的BBBBBB。此服务XX年XX月信息费为XXXX元;详情咨询:XXXXXXXXXXXX说明:公司名称限(AAAAAA):6个字之内表达业务名称限(BBBBBB):6个字内表达接入号码限(CCCC):4个字内表达信息费用限:4个字内表达咨询电话限:12个字内表达年限:2个字内表达月限:2个字内表达