广东联通联通在信技术培训文档

1、广东联通在信技术培训中国联通有限公司广东分公司sp管理系统介绍 sp管理系统结构 和短信网关旁路结构，对目前的系统结构没有大影响 sp管理系统功能 规范sp的业务流程 订制类业务需要用户二次确认 用户订购关系统一保存，订购关系以sp管理系统为准 对短信上、下行进行鉴权sp接入代理核心调度smg接入代理spsmg业务鉴权平台业务鉴权平台(鉴权中心)(鉴权中心)spspmsspmsspapspap短信门户短信门户(sp)(sp)sgipsgipspms系统体系结构系统体系结构sp管理系统（以下简称：spms）分为两个部分，一部分是短信门户，一部分是业务鉴权中心，它们与网关的关系如下图：说明：spm

2、s和spsmg之间采用“旁路结构”，双方共有两个通讯通道。其中短信门户以sp身份接入到spsmg网关（遵守sgip协议）；业务鉴权平台以鉴权中心与spsmg网关通信（遵守业务鉴权协议spap）。spms系统体系结构系统体系结构网关“smg”与“spms的业务鉴权中心”，互为客户端与服务器端，双方以业务鉴权协议（spap）来完成业务鉴权操作处理上，网关smg是将所有包（状态报告report除外），都必须强制通过spms（sp管理系统）。网关“smg”与“spms短信门户”，通过sgip协议与smg通讯。通讯流程通讯流程对原有协议的修改 修改了sgip1.2协议，对submit和deliver包使

3、用了其中的reserve字段，用来存放linkid基本概念 命令字 sp制定的点播/订制某个业务时用户在手机上输入命令格式 sp管理系统中命令字只能用a-z、a-z、0-9以及下划线中划线作为命令字，其他字符会作为命令字结束符。例如aaa#123，sp管理系统只截取aaa作为命令字 sp管理系统中命令字最大长度为12个字符 sp管理系统会将小写命令字转为大写 系统保留命令字:0000/00000/114基本概念 业务代码 又称为计费代码，是业务的标志，每个sp的业务代码不能重复 每个业务必须定义一个业务代码 点播类、订制类业务代码必须不同（视为两个业务，不能混用） 最大12个字节 全部为大写基

4、本概念 linkid 用于校验sp下发的信息合法性，目前保存在sgip中的reserve字段中 linkid是8个字节字符格式 如果下发linkid为空的包，填写数字0 对不足8位的在后面补二进制的0，不能补字符0基本概念 网上点播校验码 在用户在sp网站点播过程用发送到用户手机上的校验字符串 用户填写此校验码到sp网站 sp网站将此校验码作为linkid下发基本概念 二次确认 指用户在发送订制命令字上行后，sp管理系统会拦截此请求，发送用户订购业务的资费说明，让用户确认订购请求，用户按提示重新发送订制命令字确认后，系统会将用户第二次上行的mo送spsp需要做的工作 业务的规范化整理 sp资料

5、的整理 sp应用程序的修改业务规范化整理 设定业务类型（订制类/点播类） 每个业务必须申报，不能多个业务共用一个业务代码 订制类业务必须用户订制后才能给用户下行，订制sp可在用户没有上行的情况下下行，订制类业务不允许第三方付费。 点播类业务必须用户上行点播后才能下行，目前允许发送给第三方。 sp的每个业务必须设定一个唯一的业务代码（计费代码），业务代码不区分大小写，全部转换为大写业务规范化整理 命令字整理 每个业务必须申报命令字，点播类申报一个或多个点播命令字，订制类申报一个订制命令字和一个退订命令字 error业务代码不需要申报 命令字只能包含a-z和0-9字符，其他字符如空格和#等系统都认

6、为是命令字的结束符 每个sp的命令字必须唯一，全部为大写，只能属于一个业务 sp可申请#命令字通配符，此命令字通配符只能用于点播类业务，订制类业务不能使用#命令字通配符。业务流程用户使用手机网上使用点播订制查询退订sp网站spms网站点播订制查询退订查询退订订制 所有sp业务 某sp业务业务流程mo方式点播业务方式点播业务 用户发起mo业务点播请求 spms生成点播关系及linkid sp在下发的submit包中填写对应deliver包中的linkid spms根据linkid及点播关系进行鉴权业务流程mo方式订制业务方式订制业务 用户发起业务订制请求 spms生成临时订制关系，向用户下发订制

7、确认短信 用户重新回复命令字确认订制 spms转发deliver包给sp（带linkid） sp下发订制成功/失败通知包给用户(需要带linkid，失败通知包用业务代码error下发，此业务代码不用申报) spms根据通知包生成正式订制关系 sp根据订制规则向用户下发业务消息（不带linkid） spms根据用户订制关系进行鉴权。业务流程momo方式退订业务方式退订业务 用户发起业务退订请求 spms退订用户业务，转发deliver包给sp（带linkid） sp到deliver包，进行退订处理业务流程用户在用户在web上注册上注册sp社区用户社区用户 用户在web上注册sp社区用户 sp调用

8、spms点播接口，挂起用户请求，等待用户输入校验码 spms向用户下发校验码短信 用户收到校验码短信，在web上输入校验码 sp向用户下发密码通知消息，将用户输入的校验码填在linkid字段 spms根据校验码及点播关系进行鉴权 用户使用sp下发的密码登录sp社区业务流程web方式点播业务方式点播业务 用户登录sp社区 用户在网上点播业务 sp调用spms点播接口，挂起用户请求，等待用户输入校验码 spms向用户下发校验码短信 用户收到校验码短信，在web上输入校验码 sp下发点播消息，将用户输入的校验码填在submit包linkid字段 spms根据校验码及点播关系进行鉴权业务流程web方式

9、订制业务方式订制业务用户在web上发起业务订制请求sp调用spms提供的订制接口spms生成临时订制关系，向用户下发订制确认短信，提示用户发送命令字到sp接入号用户发送命令字mo确认订制spms发deliver包给sp（带linkid）sp下发订制成功/失败通知包用户(需要带linkid，失败通知包用业务代码error下发，此业务代码不用申报)spms根据通知包生成正式订制关系sp根据订制规则向用户下发业务消息（不带linkid）spms根据用户订制关系进行鉴权业务流程web方式退订业务方式退订业务 用户在web上发起业务退订请求 sp调用spms提供的业务订制接口 spms退订用户业务，转发

10、deliver包给sp（带linkid） sp到deliver包，进行退订处理业务流程中的常见问题 长号码 sp管理系统支持长号码的上下行，但sp申报业务是必须全以短号码申报 sp管理系统中上下行不匹配长号码，全部以短号码进行匹配。例如8000接入号和80001长号码下行的业务代码aaa会认为是一个业务，而不是两个业务 web订制和点播接口调用时只能使用短号码 订制业务时的二次确认，用户收到的提示是发送命令字到短号码业务流程中的常见问题 命令字的设计 业务命令字的命名最好避免一些有歧义性的东西，特别是对一些需要用户回复的业务。比如某sp申报某业务a的订制命令字申请为“ok“，而该sp恰好有一个

11、业务b可能需要用户的回复（比如聊天类或者游戏互动类）。业务b的订制用户在聊天后者游戏过程中可能回复ok表示某种意思，由于该回复恰好又是业务a的订制命令字，这样鉴权系统就会认为该mo是一个订制业务a的请求而不是普通的回复mo，sp也就收不到该回复的mo了，影响业务运行。业务流程中的常见问题 命令字参数的设计 对于某些需要在命令字中上行参数的业务，建议sp采用命令字+空格或者#+参数的方式来开展业务。如分地区的天气预报业务，将命令字定义为tq,用户发送tq#020或者tq 020来进行订制业务流程中的常见问题 订购流程 订购关系的建立以sp端下发对应上行订购业务代码且linkid和上行linkid

12、相匹配的mt为订购成功标志。如果sp下发error业务代码且linkid与上行linkid相匹配的mt，则sp管理系统不会建立订购关系。 建立订购关系那条mt必须填写和用户订制请求mo相同的业务代码和linkid。在订购关系成功建立后，sp下发的此订制类业务信息和包月话单不需要填写linkid（业务代码必须和用户订制的一致）业务流程中的常见问题 点播流程 点播类业务sp可申请命令字为#的业务，此命令字表示可匹配用户上行的任何命令字。（只能在点播类使用#命令字通配符） 点播类业务的下发必须有用户的点播上行，必须填写用户点播上行mo中的linkid 一条用户上行的mo中的linkid可在多条对应下

13、行的mt中使用（mo对应的最大mt数量现统一为10条）业务流程中的常见问题 sp订制/点播mo包处理失败的通知下发 对于用户上行的订制/点播mo包，如果sp端处理失败，可使用平台提供的统一业务代码 error 下发通知消息给用户（此业务代码不需要申请） 该业务代码所对应的信息费资费必须为0，付费号码必须填写21个字符0（sp支付通道费） 业务流程中的常见问题 资费 sp管理系统检查时允许资费小于或等于申报资费的mt下发。 如果mt资费大于sp申报的值，sp管理系统会对在返回错误后生成一个资费等于sp申报资费的mt下发。（此违规行为将会反映到统计日志中）业务流程中的常见问题 计费方法 点播类业务

14、支持按条付费 订制类业务支持包月计费和按条计费业务流程中的常见问题 包月话单的下发 sp的包月话单在每月10号后下发 用户订购小于3天（72小时）时，不能下发包月话单 包月话单通知到用户手机功能目前暂不实施业务流程中的常见问题 mt中各字段的填写 订制或退订成功的通知包中，业务代码字段填写该业务对应的业务代码；订制或退订失败的通知包中，业务代码固定填写error，表示sp端订制或退订失败 假设正常的业务代码为abcd，则sp下发的mt消息中各字体填写规则如下：（*表示具体的值） 业务流程中的常见问题 mt中各字段的填写 短信点播类：servicetype=abcd，momtflag=0/1，f

15、eetype=2，feevalue=*，linkid为对应上行点播包的linkid 网上点播类：servicetype=abcd，momtflag=0/1，feetype=2，feevalue=*，linkid为用户在sp网站上填的手机上收到的校验码 业务流程中的常见问题 mt中各字段的填写 订制成功通知包：servicetype=abcd，momtflag=0，feetype=1，feevalue=0，linkid为用户进行二次确认mo的linkid 订制失败通知包：servicetype=error，momtflag=2，feetype=1，feevalue=0，chargenumber=

16、000000000000000000000，linkid为用户进行二次确认mo的linkid 业务流程中的常见问题 mt中各字段的填写 退订通知包：servicetype=abcd，momtflag=0，feetype=1，feevalue=0，linkid为对应上行退订包的linkid 包月计费类订制业务包：servicetype=abcd，momtflag=2，feetype=1，feevalue=0，linkid为空 业务流程中的常见问题 mt中各字段的填写 按条计费类订制业务包：servicetype=abcd，momtflag=2，feetype=2，feevalue=*，linki

17、d为空 月租计费包：servicetype=abcd，momtflag=3，reportflag=3、feetype=3，feevalue=*，linkid为空 业务流程中的常见问题 mt中各字段的填写 sp付费包：chargenumber=00000000000000000000，servicetype=abcd，feetype=4，feevalue=0，linkid根据情况填写 00000命令字对应的退订命令包：servicetype=0000，momtflag=0，feetype=1，feevalue=0，linkid为上行对应退订mo包的linkid 业务流程中的常见问题 linkid

18、的填写 mo点播引起的mt：sp必须在submit包中填写对应的mo点播请求deliver消息中的linkid web点播引起的mt：sp必须在submit包中填写用户在web上输入的由spms下发给用户的校验码，该校验码作为mt消息的linkid 订制或退订引起的通知mt：sp必须在submit包中填写对应的订制/退订请求deliver消息中的linkid 订制成功后引起mt业务消息、月租包消息：不需要填写linkid，submit包reserve字段填空 业务流程中的常见问题 其他 临时订制和点播关系存在有效期限制，目前为3小时。即用户3小时后进行二次确认或sp在用户mo点播后3小时后以m

19、o的linkid下发mt无效 sgip包中的各个字段需按规范填写，如计费号码不能为空，sp不能下发morelatetomtflag=3的包（除包月话单外）。sp资料的整理 sp基本资料 sp业务资料 订购用户资料sp资料的整理 sp基本资料 sp基本资料xml文件中的接入省份代码provincecode填写051，接入广州全省网关、广州全国网关、深圳网关、东莞网关、佛山网关的sp接入城市代码areacode分别填写510 、511、540 、580、530 sp程序的修改 修改原sgip程序对reserve字段和序列号的处理 linkid保存在sgip协议的reserve字段，sp在下行需要填

20、写linkid的包中复制用户上行mo包中的linkid sgip包下发的序列号中的第三部分必须小于一亿。 两个新增接口 web点播接口 web订制接口sp程序的修改 序列号生成 sp下发的submit包序列号的第三部分必须小于一亿，大于一亿部分保留给sp管理系统发送noti_touser包sp程序的修改 web点播 在sp网站上点播需要先调用web点播接口，校验码会发送到用户手机 sp网站上需要提供用户填写校验码的页面，将用户填写的校验码作为linkid下发sp程序的修改 web订制/退定 在sp网站上订制需要先调用web订制接口，sp管理系统会建立临时订购关系，并提示用户通过手机上行订制命令字进行二次确认 用户在sp网站退定时，sp需要调用web订制接口（参数传业务的退订命令字），退定sp管理系统上的订购关系，否则用户查询时订购关系仍然存在。web点播/订制接口的格式 点播接口格式 订制接口格式web点播/订制接口中的加密 采用3des方式加密 模式为ecb（电子密码本） 填充算法为pkcs#7 密钥为192位 密钥和加密后的串都需要base64编码测试工具 提供给sp的校验工具 3des加密校验工具 同步资料格式校验工具 以上工具需要microsoft .net