中国联通“联通在信”业务
SP 业务接入FAQ
1、FAQ 问题集
1. 企业号(CorpId )与接入号(SpNumber )的关系?
一个SP 具有唯一一个企业号,特殊情况下一个SP 允许向联通申请多个接入号,即企业号与接入号可为一对多的关系,但接入号是唯一的。
2. MT 消息的分类?
SP 能够下发的MT 消息只有点播和订制两类,订制消息包括订制通知包、订制后的业务消息、退订后的通知包、月租计费包四种,除此外SP 不能向用户下发其它类型的MT 消息。
SP 申报业务代码时,业务代码对应的业务类别(RequestType )只有两类:1为点播,2为订制。
3. 长号码的问题?
SP 申报定制业务时,不能使用长号码,但SP 可使用长号码开展业务,如QQ 聊天类业务,接入号可为9777+QQ号,长号码的解析由SP 自行定义,申报业务时以短号码申报。
在点播类业务中,SP 可使用长号码(MO 和MT 都可以),申报时要说明(word 文档格式,按原有的申报流程)。在提供给SPMS 的SP 业务资料同步接口中,SPNumber 以短号方式提交,实际开展业务时,解析由SP 自行定义。
4. MO 指令中如何区分业务?
SPMS 系统以短号码+命令字来区分业务,SP 申报业务时,只能使用短号码进行申报,不能使用长号码。如接入号9163加命令字ABC 和接入号916301加命令ABC 会被解析为同一个业务请求。
5. 命令字如何解析?
命令字最大长度为12位字符,命令字只能由“0-9”、“A-Z ”、“a-z ”、“-_”此64个字符构成,不能使用其它特殊字符,SPMS 解析命令字时,遇到除此64个字符外的其它字符,即认为命令字已结束,如TQDZ 010、TQDZ 020 、TQDZ#020会被解析为同一个业务请求。
在某些SP 的业务中,存在如下情况,如对于天气预报业务,订制北京天气预报指令为DZTQ 010,订制广州天气预报指令为DZTQ 020,这种情况下SP 应分为多个业务,将指令分开,不能都用DZTQ 。
在MO 业务请求消息中,建议命令字与其它内容以空格或#号分隔。
6. SP 是否能提供第3方付费业务?
目前不允许开通第3方付费的订制业务,对于付费号码和接收号码不一致的订制类业务,SPMS 将不允许下发;点播类第3方付费业务,目前仍然支持。
7. SPMS 系统开通后,正常业务流程如何实现?
A. MO 方式点播业务:用户发起MO 业务点播请求->SPMS生成点播关系及LinkID ->SP在下
发的Submit 包中填写对应Deliver 包中的LinkID ->SPMS根据LinkID 及点播关系进行鉴权。
B. MO 方式订制业务:用户发起业务订制请求->SPMS生成临时订制关系,向用户下发订制
确认短信->用户重新回复命令字确认订制->SPMS转发Deliver 包给SP (带LinkID )->SP下发订制成功/失败通知包给用户(需要带LinkID ,失败通知包用业务代码ERROR 下发,此业务代码不用申报) ->SPMS根据通知包生成正式订制关系,拦截SP 的订制成功通知,采用平台统一格式下发订制成功通知,返回错误代码44->SP根据订制规则向用户下发业务消息(不带LinkID )->SPMS根据用户订制关系进行鉴权。
C. MO 方式退订业务:用户发起业务退订请求-> SPMS 退订用户业务,转发Deliver 包给SP
(带LinkID )->SP到Deliver 包,进行退订处理。
D. 用户在WEB 上注册SP 社区用户:用户在WEB 上注册SP 社区用户->SP调用SPMS 点播接
口,挂起用户请求,等待用户输入确认码->SPMS向用户下发确认码短信->用户收到确认码短信,在WEB 上输入确认码->SP向用户下发密码通知消息,将用户输入的确认码填在LinkID 字段->SPMS根据确认码及点播关系进行鉴权->用户使用SP 下发的密码登录SP
E. WEB 方式点播业务:用户登录SP 社区->用户在网上点播业务->SP调用SPMS 点播接口,
挂起用户请求,等待用户输入确认码->SPMS向用户下发确认码短信->用户收到确认码短信,在WEB 上输入确认码->SP下发点播消息,将用户输入的确认码填在Sumit 包LinkID 字段->SPMS根据确认码及点播关系进行鉴权。
F. WEB 方式订制业务:用户在WEB 上发起业务订制请求->SP调用SPMS 提供的定购接口
->SPMS生成临时订制关系,向用户下发订制确认短信,提示用户发送命令字到SP 接入号->用户发送命令字MO 确认订制->SPMS发Deliver 包给SP (带LinkID )->SP下发订制成功/失败通知包用户(需要带LinkID ,失败通知包用业务代码ERROR 下发,此业务代码不用申报) ->SPMS根据通知包生成正式订制关系->SP根据订制规则向用户下发业务消息(不带LinkID )->SPMS根据用户订制关系进行鉴权。
G. WEB 方式退订业务:用户在WEB 上发起业务退订请求->SP调用SPMS 提供的业务退订接
口-> SPMS退订用户业务,转发Deliver 包给SP (带LinkID )-> SP到Deliver 包,进行退订处理。
8. MT 消息中SP 如何填写LinkID ?
A. MO 点播引起的MT :SP 必须在Submit 包中填写对应的MO 点播请求Deliver 消息中的
LinkID 。
B. WEB 点播引起的MT :SP 必须在Submit 包中填写用户在WEB 上输入的由SPMS 下发给用户
的确认码,该确认码作为MT 消息的LinkID 。
C. 订制或退订引起的通知MT :SP 必须在Submit 包中填写对应的订制/退订请求Deliver 消
息中的LinkID 。
D. 订制成功后引起MT 业务消息、月租包消息:不需要填写LinkID ,Submit 包Reserve 字
段填空。
9. 用户发起命令字为0000的业务退订请求如何处理?
用户发起命令字为0000的业务请求,表示用户退订此SP 的所有业务,SPMS 会处理用户业务全退订请求,SP 也必须处理该指令,将用户的全部业务定购取消。
0000的命令字所对应的业务代码为0000;信息费为0, 付费号码填写21个字符0(即SP 支付通道费) 。
10. 是否支持00000返回菜单形式的业务退订形式?
不支持!
11. SP 付费业务如何处理?
SP 提供的SP 付费业务必须作为一种订制业务提供给用户,SP 只能向订制此类业务的用户发送SP 付费的消息,计费号码填全0,信息费填0,通信费由SP 支付。
12. SP 下发的MT 消息中ServiceType 、MoMtFlag 、FeeType 、FeeValue 等字段如何填写?
订制或退订成功的通知包中,业务代码字段填写该业务对应的业务代码;订制或退订失败的通知包中,业务代码固定填写ERROR ,表示SP 端订制或退订失败。
假设正常的业务代码为ABCD ,则SP 下发的MT 消息中各字体填写规则如下:(**表示具体的值) A. 短信点播类:ServiceType=ABCD,MoMtFlag=0/1,FeeType=2,FeeValue=** B. 网上点播类:ServiceType=ABCD,MoMtFlag=0/1,FeeType=2,FeeValue=** C. 订制成功通知包:ServiceType=ABCD,MoMtFlag=0,FeeType=1,FeeValue=0
D. 订制失败通知包:ServiceType=ERROR,MoMtFlag=2,FeeType=1,FeeValue=0,
Chargenumber=[***********]000
E. 退订成功通知包:ServiceType=ABCD,MoMtFlag=0,FeeType=1,FeeValue=0
F. 退订失败通知包:ServiceType=ERROR,MoMtFlag=2,FeeType=1,FeeValue=0,
Chargenumber=[***********]000
G. 包月计费类订制业务包:ServiceType=ABCD,MoMtFlag=2,FeeType=1,FeeValue=0 H. 按条计费类订制业务包:ServiceType=ABCD,MoMtFlag=2,FeeType=2,FeeValue=** I. 月租计费包:ServiceType=ABCD,MoMtFlag=2,ReportFlag=3、FeeType=3,FeeValue=** J. SP 付费包:ChargeNumber=[***********]00,ServiceType=ABCD,FeeType=4,
FeeValue=0
K. 0000命令字对应的退订命令包:ServiceType=0000,MoMtFlag=0,FeeType=1,FeeValue=0
13. 是否有WEB 形式的定购取消接口
WEB 形式的订制取消和订制使用同一个接口,SPMS 根据命令字自动判断该请求是订制请求还是退订请求。
14. 在SP 业务资料同步接口中,一个业务的订制和退订是否是2行记录?
在SP 业务资料同步接口中,一个订制业务只有一行记录,订制命令字和退订命令字是一行数据中的两个字段。
15. SP 基本资料接口中,XML 文件的XSD 定义是什么?
16、如果SP 处理定制的MO 包不成功,如何下发通知信息?
平台提供了统一的ERROR 的业务代码,该业务代码所对应的信息费资费必须为0,付费号码必须填写21个字符0(SP 支付通道费)。
17、SP 能否提供帮助的业务代码?
SP 必须单独申报,如果申报成功,该业务代码所对应的信息费自费必须为0,付费号码必须填写21个字符0(SP支付通道费) 。
18、密钥的获取方式是什么?
各SP 登陆到SP 自服务系统上,在菜单上选择获取密钥,SPMS 系统就会将密钥以BASE64的方式编码后的ASCII 码字符串发送到SP 在基本资料同步接口上提供的联系人EMAIL 邮箱中去。
19、铃声图片点播业务中, SP如何下发MT 包?
这种情况下,SP 需要将MT 包拆分;所有的拆分包中,业务代码填写该业务对应的业务代码,LinkID 填写用户MO 包或在网上填写的确认码;第一个包填写应收的信息费,其他包的信息费必须为0。
2、资料填写样例
以下以CorpID 为30008, SpNumber 为9999的SP 申请的体育新闻的点播和定制业务,以及游戏的点播和定制业务为范例,其中游戏的点播命令字超过10个以上。
2.1新增业务申请(若此次规范后,新增的业务代码规范填写格式,用于联通报备),非新增的已经运行的业务代码无需报备 2.1.1点播类业务申请表:(按此规范报备)
2.1.2定制类业务申请表:
2.2 SP基本资料同步接口
◆ 接口形式:XML 文件
◆ 同步时间:已经接入到联通在信的SP ,可通过XML 文件形式一次性将SP
的基本信息同步给
SP 管理系统。(SP 也可不使用该接口,而直接登录SP 管理系统的SP 自服务门户,以手工录入的方法将SP 基本信息提交给SP 管理系统。)
◆ 文件命名:SPBI + 5位SP 企业代码 + 8位时间 + 4位序号.TXT
如:SPBI[**************]01.XML
◆ 文件内容:文件以XML 格式存储,XML 文件中所有字段的类型定义为String 型,XML 文件
属性定义如下:
CorpID=30008, SpNumber=9999的SP 做基本资料同步时填写如下:
对应XML 内容如下:
30008 9999
SpShortname SP中文名称 SP英文名称 0
2003-11-24 0
John John 1000
5000000
这里是SP 的介绍 www.sp.com.cn 公司的主营业务 010
010
电信信息服务许可证编号
电信信息服务许可证颁发单位 营业执照号
主管登记机关 业务经营范围 SP开户银行 银行帐号 公司地址 40000
SP公司电话 SP传真号码
SP投诉电话 2008-11-24 2003-11-24 Jerry
Jerry
010666666
[1**********] [email protected] 联系人姓名 联系人职务 [1**********] [1**********] [email protected] 2003-11-24 2003-11-24
2.3 SP业务资料同步接口
◆ 接口形式:文本文件
◆ 同步时间:已经接入到联通在信的SP ,需通过文件形式将SP 已开通的业务信息同步给SP 管
理系统,SP 管理系统根据已接入的业务资料对MO/MT消息进行鉴权。 ◆ 文件命名:SPST + 5位SP 企业代码 + 8位时间 + 4位序号.TXT
如:SPST[**************]01.TXT
文件内容:文件采用ASCII 文本格式,文件体中一行作为一条记录,每一条记录代表sp 的一
个业务,记录的属性值按顺序排列,各属性间使用‘\t’分隔。各条记录之间用换行符作为分隔。
接入号为9999的SP 申请的定制类游戏业务格式如下(业务代码为CSYX ),实例见附件文件:
该SP 申请的点播类体育新闻业务格式如下(业务代码为TYXWD, 共2条记录, 区别在于命令字不同)
该SP 申请的点播类游戏业务格式如下:(业务代码为CSYXD
2.4 用户业务定购资料
◆ 文件命名:SPUS + 5位SP 企业代码 + 8位时间 + 4位序号.TXT
如:SPUS[**************]01.TXT
◆ 文件采用ASCII 文本格式,文件体中一行作为一条记录,每一条记录代表手机用户订购的一
个业务,每条记录的属性值按顺序排列,各属性间使用‘\t’分隔,一个手机订购多项业务需要多条记录,各条记录之间用换行符作为分隔。
每个文件最大记录数为10万条,超过的需要按照文件序列号递增的方式生成新的文件。(要求:UserNumber 必须和ChargeNumber 一致;对于不一致的用户业务订购关系,SPMS 系统将强制一致性,以ChargeNumber 为准)
手机号为[1**********]的用户在2004年2月13日10点定购了该项体育新闻定制服务,则填写格式如下:(实例见附件文件:SPST[**************]01.TXT )
手机号为[1**********]的用户在2004年2月28日12点退订了该项体育新闻定制服务,则填写格式如下:
2.5 SP业务定购WEB 调用接口
◆ 接口说明:用户在SP 网站上登录,选择订购的产品,在SP 网站完成预订购过程。
预订购时SP 调用此接口,接口方式为标准的HTTP ,参数传递采用GET 方式,传递的参数包含SP 代码、用户手机号码、业务代码、定购时间。其中SP 代码采用明文传递,其他参数采用SP 的密钥加密,SP 密钥由SP 管理系统和SP 共同保存。SP 管理系统返回给SP 预订购请求是否成功。 ◆ HTTP 调用参数:
EncodeStr 生成算法如下:
EncodeStr = URLEncoding(Base64(Encrypt(SpNumber + “$”+ UserNumber + “$”+
ServiceTag + “$”+ AccessTime )))
URLEncoding 是指对BASE64编码中的HTML 控制码进行转义的过程,其具体实现参见RFC1738。
Encrypt 加密算法采用3-DES 算法,密钥为64位。
调用示例:
http://www.unispms.com/subscription/serviceredir.aspx?SPNumber=9999&AccessTime=2004-02-28 10:10:10&EncodeStr=KIQWNWEQREQWK921343KJASDFASD
(示例,此URL 并不存在)
EncodeStr 中加密前的样例为:9999$[1**********]$ TYDZ$2004-02-28 10:00:00(表示定制体育新闻业务)
◆ HTTP 调用返回参数
A. SPMS 处理成功:返回“OK ”。
B. SPMS 处理失败:返回“Error$[错误码]”。
2.6 SP业务点播用户确认接口
◆ 用户身份验证:SP 必须先对用户以手机号注册,注册成功并登陆SP 社区后用户才
能发起业务点播请求,即SP 必须保证点播用户的真实性。
◆ 接口说明:用户在SP 站点上点播业务时,需要确认该点播是由用户主动发起,所
以要求用户点播时输入由SPMS 提供的点播确认码(该点播确认码是由SPMS 以短信方式下发给在网上进行点播操作的用户手机)。 ◆ HTTP 点播调用参数
EncodeStr 生成算法如下:
EncodeStr = URLEncoding(Base64(Encrypt(SpNumber + “$”+ UserNumber + “$”+
ServiceTag + “$”+ AccessTime )))
URLEncoding 是指对BASE64编码中的HTML 控制码进行转义的过程,其具体实现参见RFC1738。
Encrypt 加密算法采用3-DES 算法,密钥为64位。
调用示例:
http://www.unispms.com/subscription/servicepull.aspx?SPNumber=9999&AccessTime=2004-03-01 10:10:10&EncodeStr=KIQWNWEQREQWK921343KJ (示例,此URL 并不存在)
EncodeStr 中加密前的样例为:9999$[1**********]$####(针对游戏)$2004-03-01 10:10:10(表示点播cs 游戏业务) ◆ HTTP 点播调用返回参数
SP 调用HTTP 点播接口后,返回调用结果。 A. 处理成功:返回“OK ”。
B. 处理失败:返回“Error$” + 错误码。 ◆ 处理流程
A. 用户在SP 站点点播业务时,SP 网站向SP 管理系统的获取点播接口提交一个请求。接口
方式为标准的HTTP ,若处理成功,返回值“OK ”。 B. SPMS 将给网上点播操作的用户的手机发送点播确认码。
C. SP 网站将提供一个点播确认码输入显示在订购的页面上,用户填写点播确认码,用户提
交点播请求,SP 将点播确认码作为LinkID ,填写到MT 包中的Reserved 字段中,提交MT 到SPSMG 。
SPSMG 接收到此MT 请求,交给SP 管理系统中的业务鉴权中心,业务鉴权中心读取数据库,发现此LinkID (点播确认码) 有效,允许发送。
中国联通“联通在信”业务
SP 业务接入FAQ
1、FAQ 问题集
1. 企业号(CorpId )与接入号(SpNumber )的关系?
一个SP 具有唯一一个企业号,特殊情况下一个SP 允许向联通申请多个接入号,即企业号与接入号可为一对多的关系,但接入号是唯一的。
2. MT 消息的分类?
SP 能够下发的MT 消息只有点播和订制两类,订制消息包括订制通知包、订制后的业务消息、退订后的通知包、月租计费包四种,除此外SP 不能向用户下发其它类型的MT 消息。
SP 申报业务代码时,业务代码对应的业务类别(RequestType )只有两类:1为点播,2为订制。
3. 长号码的问题?
SP 申报定制业务时,不能使用长号码,但SP 可使用长号码开展业务,如QQ 聊天类业务,接入号可为9777+QQ号,长号码的解析由SP 自行定义,申报业务时以短号码申报。
在点播类业务中,SP 可使用长号码(MO 和MT 都可以),申报时要说明(word 文档格式,按原有的申报流程)。在提供给SPMS 的SP 业务资料同步接口中,SPNumber 以短号方式提交,实际开展业务时,解析由SP 自行定义。
4. MO 指令中如何区分业务?
SPMS 系统以短号码+命令字来区分业务,SP 申报业务时,只能使用短号码进行申报,不能使用长号码。如接入号9163加命令字ABC 和接入号916301加命令ABC 会被解析为同一个业务请求。
5. 命令字如何解析?
命令字最大长度为12位字符,命令字只能由“0-9”、“A-Z ”、“a-z ”、“-_”此64个字符构成,不能使用其它特殊字符,SPMS 解析命令字时,遇到除此64个字符外的其它字符,即认为命令字已结束,如TQDZ 010、TQDZ 020 、TQDZ#020会被解析为同一个业务请求。
在某些SP 的业务中,存在如下情况,如对于天气预报业务,订制北京天气预报指令为DZTQ 010,订制广州天气预报指令为DZTQ 020,这种情况下SP 应分为多个业务,将指令分开,不能都用DZTQ 。
在MO 业务请求消息中,建议命令字与其它内容以空格或#号分隔。
6. SP 是否能提供第3方付费业务?
目前不允许开通第3方付费的订制业务,对于付费号码和接收号码不一致的订制类业务,SPMS 将不允许下发;点播类第3方付费业务,目前仍然支持。
7. SPMS 系统开通后,正常业务流程如何实现?
A. MO 方式点播业务:用户发起MO 业务点播请求->SPMS生成点播关系及LinkID ->SP在下
发的Submit 包中填写对应Deliver 包中的LinkID ->SPMS根据LinkID 及点播关系进行鉴权。
B. MO 方式订制业务:用户发起业务订制请求->SPMS生成临时订制关系,向用户下发订制
确认短信->用户重新回复命令字确认订制->SPMS转发Deliver 包给SP (带LinkID )->SP下发订制成功/失败通知包给用户(需要带LinkID ,失败通知包用业务代码ERROR 下发,此业务代码不用申报) ->SPMS根据通知包生成正式订制关系,拦截SP 的订制成功通知,采用平台统一格式下发订制成功通知,返回错误代码44->SP根据订制规则向用户下发业务消息(不带LinkID )->SPMS根据用户订制关系进行鉴权。
C. MO 方式退订业务:用户发起业务退订请求-> SPMS 退订用户业务,转发Deliver 包给SP
(带LinkID )->SP到Deliver 包,进行退订处理。
D. 用户在WEB 上注册SP 社区用户:用户在WEB 上注册SP 社区用户->SP调用SPMS 点播接
口,挂起用户请求,等待用户输入确认码->SPMS向用户下发确认码短信->用户收到确认码短信,在WEB 上输入确认码->SP向用户下发密码通知消息,将用户输入的确认码填在LinkID 字段->SPMS根据确认码及点播关系进行鉴权->用户使用SP 下发的密码登录SP
E. WEB 方式点播业务:用户登录SP 社区->用户在网上点播业务->SP调用SPMS 点播接口,
挂起用户请求,等待用户输入确认码->SPMS向用户下发确认码短信->用户收到确认码短信,在WEB 上输入确认码->SP下发点播消息,将用户输入的确认码填在Sumit 包LinkID 字段->SPMS根据确认码及点播关系进行鉴权。
F. WEB 方式订制业务:用户在WEB 上发起业务订制请求->SP调用SPMS 提供的定购接口
->SPMS生成临时订制关系,向用户下发订制确认短信,提示用户发送命令字到SP 接入号->用户发送命令字MO 确认订制->SPMS发Deliver 包给SP (带LinkID )->SP下发订制成功/失败通知包用户(需要带LinkID ,失败通知包用业务代码ERROR 下发,此业务代码不用申报) ->SPMS根据通知包生成正式订制关系->SP根据订制规则向用户下发业务消息(不带LinkID )->SPMS根据用户订制关系进行鉴权。
G. WEB 方式退订业务:用户在WEB 上发起业务退订请求->SP调用SPMS 提供的业务退订接
口-> SPMS退订用户业务,转发Deliver 包给SP (带LinkID )-> SP到Deliver 包,进行退订处理。
8. MT 消息中SP 如何填写LinkID ?
A. MO 点播引起的MT :SP 必须在Submit 包中填写对应的MO 点播请求Deliver 消息中的
LinkID 。
B. WEB 点播引起的MT :SP 必须在Submit 包中填写用户在WEB 上输入的由SPMS 下发给用户
的确认码,该确认码作为MT 消息的LinkID 。
C. 订制或退订引起的通知MT :SP 必须在Submit 包中填写对应的订制/退订请求Deliver 消
息中的LinkID 。
D. 订制成功后引起MT 业务消息、月租包消息:不需要填写LinkID ,Submit 包Reserve 字
段填空。
9. 用户发起命令字为0000的业务退订请求如何处理?
用户发起命令字为0000的业务请求,表示用户退订此SP 的所有业务,SPMS 会处理用户业务全退订请求,SP 也必须处理该指令,将用户的全部业务定购取消。
0000的命令字所对应的业务代码为0000;信息费为0, 付费号码填写21个字符0(即SP 支付通道费) 。
10. 是否支持00000返回菜单形式的业务退订形式?
不支持!
11. SP 付费业务如何处理?
SP 提供的SP 付费业务必须作为一种订制业务提供给用户,SP 只能向订制此类业务的用户发送SP 付费的消息,计费号码填全0,信息费填0,通信费由SP 支付。
12. SP 下发的MT 消息中ServiceType 、MoMtFlag 、FeeType 、FeeValue 等字段如何填写?
订制或退订成功的通知包中,业务代码字段填写该业务对应的业务代码;订制或退订失败的通知包中,业务代码固定填写ERROR ,表示SP 端订制或退订失败。
假设正常的业务代码为ABCD ,则SP 下发的MT 消息中各字体填写规则如下:(**表示具体的值) A. 短信点播类:ServiceType=ABCD,MoMtFlag=0/1,FeeType=2,FeeValue=** B. 网上点播类:ServiceType=ABCD,MoMtFlag=0/1,FeeType=2,FeeValue=** C. 订制成功通知包:ServiceType=ABCD,MoMtFlag=0,FeeType=1,FeeValue=0
D. 订制失败通知包:ServiceType=ERROR,MoMtFlag=2,FeeType=1,FeeValue=0,
Chargenumber=[***********]000
E. 退订成功通知包:ServiceType=ABCD,MoMtFlag=0,FeeType=1,FeeValue=0
F. 退订失败通知包:ServiceType=ERROR,MoMtFlag=2,FeeType=1,FeeValue=0,
Chargenumber=[***********]000
G. 包月计费类订制业务包:ServiceType=ABCD,MoMtFlag=2,FeeType=1,FeeValue=0 H. 按条计费类订制业务包:ServiceType=ABCD,MoMtFlag=2,FeeType=2,FeeValue=** I. 月租计费包:ServiceType=ABCD,MoMtFlag=2,ReportFlag=3、FeeType=3,FeeValue=** J. SP 付费包:ChargeNumber=[***********]00,ServiceType=ABCD,FeeType=4,
FeeValue=0
K. 0000命令字对应的退订命令包:ServiceType=0000,MoMtFlag=0,FeeType=1,FeeValue=0
13. 是否有WEB 形式的定购取消接口
WEB 形式的订制取消和订制使用同一个接口,SPMS 根据命令字自动判断该请求是订制请求还是退订请求。
14. 在SP 业务资料同步接口中,一个业务的订制和退订是否是2行记录?
在SP 业务资料同步接口中,一个订制业务只有一行记录,订制命令字和退订命令字是一行数据中的两个字段。
15. SP 基本资料接口中,XML 文件的XSD 定义是什么?
16、如果SP 处理定制的MO 包不成功,如何下发通知信息?
平台提供了统一的ERROR 的业务代码,该业务代码所对应的信息费资费必须为0,付费号码必须填写21个字符0(SP 支付通道费)。
17、SP 能否提供帮助的业务代码?
SP 必须单独申报,如果申报成功,该业务代码所对应的信息费自费必须为0,付费号码必须填写21个字符0(SP支付通道费) 。
18、密钥的获取方式是什么?
各SP 登陆到SP 自服务系统上,在菜单上选择获取密钥,SPMS 系统就会将密钥以BASE64的方式编码后的ASCII 码字符串发送到SP 在基本资料同步接口上提供的联系人EMAIL 邮箱中去。
19、铃声图片点播业务中, SP如何下发MT 包?
这种情况下,SP 需要将MT 包拆分;所有的拆分包中,业务代码填写该业务对应的业务代码,LinkID 填写用户MO 包或在网上填写的确认码;第一个包填写应收的信息费,其他包的信息费必须为0。
2、资料填写样例
以下以CorpID 为30008, SpNumber 为9999的SP 申请的体育新闻的点播和定制业务,以及游戏的点播和定制业务为范例,其中游戏的点播命令字超过10个以上。
2.1新增业务申请(若此次规范后,新增的业务代码规范填写格式,用于联通报备),非新增的已经运行的业务代码无需报备 2.1.1点播类业务申请表:(按此规范报备)
2.1.2定制类业务申请表:
2.2 SP基本资料同步接口
◆ 接口形式:XML 文件
◆ 同步时间:已经接入到联通在信的SP ,可通过XML 文件形式一次性将SP
的基本信息同步给
SP 管理系统。(SP 也可不使用该接口,而直接登录SP 管理系统的SP 自服务门户,以手工录入的方法将SP 基本信息提交给SP 管理系统。)
◆ 文件命名:SPBI + 5位SP 企业代码 + 8位时间 + 4位序号.TXT
如:SPBI[**************]01.XML
◆ 文件内容:文件以XML 格式存储,XML 文件中所有字段的类型定义为String 型,XML 文件
属性定义如下:
CorpID=30008, SpNumber=9999的SP 做基本资料同步时填写如下:
对应XML 内容如下:
30008 9999
SpShortname SP中文名称 SP英文名称 0
2003-11-24 0
John John 1000
5000000
这里是SP 的介绍 www.sp.com.cn 公司的主营业务 010
010
电信信息服务许可证编号
电信信息服务许可证颁发单位 营业执照号
主管登记机关 业务经营范围 SP开户银行 银行帐号 公司地址 40000
SP公司电话 SP传真号码
SP投诉电话 2008-11-24 2003-11-24 Jerry
Jerry
010666666
[1**********] [email protected] 联系人姓名 联系人职务 [1**********] [1**********] [email protected] 2003-11-24 2003-11-24
2.3 SP业务资料同步接口
◆ 接口形式:文本文件
◆ 同步时间:已经接入到联通在信的SP ,需通过文件形式将SP 已开通的业务信息同步给SP 管
理系统,SP 管理系统根据已接入的业务资料对MO/MT消息进行鉴权。 ◆ 文件命名:SPST + 5位SP 企业代码 + 8位时间 + 4位序号.TXT
如:SPST[**************]01.TXT
文件内容:文件采用ASCII 文本格式,文件体中一行作为一条记录,每一条记录代表sp 的一
个业务,记录的属性值按顺序排列,各属性间使用‘\t’分隔。各条记录之间用换行符作为分隔。
接入号为9999的SP 申请的定制类游戏业务格式如下(业务代码为CSYX ),实例见附件文件:
该SP 申请的点播类体育新闻业务格式如下(业务代码为TYXWD, 共2条记录, 区别在于命令字不同)
该SP 申请的点播类游戏业务格式如下:(业务代码为CSYXD
2.4 用户业务定购资料
◆ 文件命名:SPUS + 5位SP 企业代码 + 8位时间 + 4位序号.TXT
如:SPUS[**************]01.TXT
◆ 文件采用ASCII 文本格式,文件体中一行作为一条记录,每一条记录代表手机用户订购的一
个业务,每条记录的属性值按顺序排列,各属性间使用‘\t’分隔,一个手机订购多项业务需要多条记录,各条记录之间用换行符作为分隔。
每个文件最大记录数为10万条,超过的需要按照文件序列号递增的方式生成新的文件。(要求:UserNumber 必须和ChargeNumber 一致;对于不一致的用户业务订购关系,SPMS 系统将强制一致性,以ChargeNumber 为准)
手机号为[1**********]的用户在2004年2月13日10点定购了该项体育新闻定制服务,则填写格式如下:(实例见附件文件:SPST[**************]01.TXT )
手机号为[1**********]的用户在2004年2月28日12点退订了该项体育新闻定制服务,则填写格式如下:
2.5 SP业务定购WEB 调用接口
◆ 接口说明:用户在SP 网站上登录,选择订购的产品,在SP 网站完成预订购过程。
预订购时SP 调用此接口,接口方式为标准的HTTP ,参数传递采用GET 方式,传递的参数包含SP 代码、用户手机号码、业务代码、定购时间。其中SP 代码采用明文传递,其他参数采用SP 的密钥加密,SP 密钥由SP 管理系统和SP 共同保存。SP 管理系统返回给SP 预订购请求是否成功。 ◆ HTTP 调用参数:
EncodeStr 生成算法如下:
EncodeStr = URLEncoding(Base64(Encrypt(SpNumber + “$”+ UserNumber + “$”+
ServiceTag + “$”+ AccessTime )))
URLEncoding 是指对BASE64编码中的HTML 控制码进行转义的过程,其具体实现参见RFC1738。
Encrypt 加密算法采用3-DES 算法,密钥为64位。
调用示例:
http://www.unispms.com/subscription/serviceredir.aspx?SPNumber=9999&AccessTime=2004-02-28 10:10:10&EncodeStr=KIQWNWEQREQWK921343KJASDFASD
(示例,此URL 并不存在)
EncodeStr 中加密前的样例为:9999$[1**********]$ TYDZ$2004-02-28 10:00:00(表示定制体育新闻业务)
◆ HTTP 调用返回参数
A. SPMS 处理成功:返回“OK ”。
B. SPMS 处理失败:返回“Error$[错误码]”。
2.6 SP业务点播用户确认接口
◆ 用户身份验证:SP 必须先对用户以手机号注册,注册成功并登陆SP 社区后用户才
能发起业务点播请求,即SP 必须保证点播用户的真实性。
◆ 接口说明:用户在SP 站点上点播业务时,需要确认该点播是由用户主动发起,所
以要求用户点播时输入由SPMS 提供的点播确认码(该点播确认码是由SPMS 以短信方式下发给在网上进行点播操作的用户手机)。 ◆ HTTP 点播调用参数
EncodeStr 生成算法如下:
EncodeStr = URLEncoding(Base64(Encrypt(SpNumber + “$”+ UserNumber + “$”+
ServiceTag + “$”+ AccessTime )))
URLEncoding 是指对BASE64编码中的HTML 控制码进行转义的过程,其具体实现参见RFC1738。
Encrypt 加密算法采用3-DES 算法,密钥为64位。
调用示例:
http://www.unispms.com/subscription/servicepull.aspx?SPNumber=9999&AccessTime=2004-03-01 10:10:10&EncodeStr=KIQWNWEQREQWK921343KJ (示例,此URL 并不存在)
EncodeStr 中加密前的样例为:9999$[1**********]$####(针对游戏)$2004-03-01 10:10:10(表示点播cs 游戏业务) ◆ HTTP 点播调用返回参数
SP 调用HTTP 点播接口后,返回调用结果。 A. 处理成功:返回“OK ”。
B. 处理失败:返回“Error$” + 错误码。 ◆ 处理流程
A. 用户在SP 站点点播业务时,SP 网站向SP 管理系统的获取点播接口提交一个请求。接口
方式为标准的HTTP ,若处理成功,返回值“OK ”。 B. SPMS 将给网上点播操作的用户的手机发送点播确认码。
C. SP 网站将提供一个点播确认码输入显示在订购的页面上,用户填写点播确认码,用户提
交点播请求,SP 将点播确认码作为LinkID ,填写到MT 包中的Reserved 字段中,提交MT 到SPSMG 。
SPSMG 接收到此MT 请求,交给SP 管理系统中的业务鉴权中心,业务鉴权中心读取数据库,发现此LinkID (点播确认码) 有效,允许发送。