互联星空技术规范SP系统接口分册V12Word文档下载推荐.docx
- 文档编号:6115733
- 上传时间:2023-05-06
- 格式:DOCX
- 页数:102
- 大小:126.68KB
互联星空技术规范SP系统接口分册V12Word文档下载推荐.docx
《互联星空技术规范SP系统接口分册V12Word文档下载推荐.docx》由会员分享,可在线阅读,更多相关《互联星空技术规范SP系统接口分册V12Word文档下载推荐.docx(102页珍藏版)》请在冰点文库上搜索。
5.2互联星空系统提供的接口32
5.2.1认证接口32
5.2.2计次支付接口34
5.2.3包时段订购支付接口36
5.2.4包次订购支付接口39
5.2.5包次使用记录通知接口41
5.2.6锁定接口43
5.2.7续锁定接口46
5.2.8计流量支付接口48
5.2.9计时长支付接口51
5.2.10包时段服务使用记录通知接口53
5.2.11支付确认接口55
5.2.12总帐对帐接口57
5.2.13明细帐对帐接口59
5.2.14取消包时段订购接口61
5.2.15服务项目信息批量上传接口64
5.2.16离线支付接口68
6附录71
6.1附录1-省份标识表71
6.2附录2-编码规则71
6.2.1UserID71
6.2.2NickName72
6.2.3SPID72
6.2.4SPSecret72
6.2.5ServiceID72
6.2.6ServiceItemID72
6.2.7TransactionID72
6.3附录3-UserProfile格式73
6.4附录4
-服务类型的schema定义73
6.4.1影视73
6.4.2音乐76
1
编制说明
1.1目的
为了指导服务提供商(SP)开发与中国电信互联星空系统对接的应用,特制定本规范。
本规范为中国电信集团公司企业规范,规定了SP系统与中国电信互联星空系统之间的应用层接口协议。
1.2解释权
本规范由中国电信集团广州研发中心起草。
本规范的解释权属于中国电信集团公司。
1.3参考标准和文献
下列标准所包含的条文,通过本标准的引用而构成本标准的条文。
在标准出版时,所示版本均为有效。
所有标准都会被修改,使用本标准的各方应探讨使用下列标准最新版本的可能性。
●RFC1738统一资源定位器(URL)
●RFC2068超文本传输协议HTTP/1.1
●RFC2109HTTP状态管理机制
●RFC2145HTTP版本号的使用和解释
●RFC1521BASE64算法
●RFC18513DES算法
●RFC1852SHA算法
●IETFSSLV1.1(1996.1)安全套接层SecureSocketLayer
●《ChinaVnet互联星空业务规范书(试行)》2002
2名词术语
SP(ServiceProvider)
加入到互联星空计划,提供收费服务的服务提供商。
互联星空用户
在互联星空系统中注册,使用互联星空服务的互联网用户,简称为用户。
互联星空系统
用于支撑中国电信互联星空业务的业务支撑系统,该系统是一套分布式的系统,分布在多个省份。
一点认证
SP系统建立对互联星空系统的信任联系。
用户只要通过互联星空系统的认证,即可自由地访问SP提供的收费服务,而不需要再次输入SP系统的认证信息;
通过与互联星空系统之间的通讯,SP系统也可以确保该用户是合法用户,从而为之提供服务。
绑定
用户指定其拥有的电信帐号作为其互联星空帐号付费手段的过程。
接入
SP与中国电信签约后,需要对其原有系统进行改造,与互联星空系统实现互通,为用户提供一点认证等服务、实现与中国电信对帐结算等功能。
这个过程称为SP接入互联星空系统(包括省级中心和全国中心。
全国中心可看作为一个特殊的省级中心,本文统一称为省级中心)。
支付帐号
用户拥有的中国电信帐号(如窄带帐号、宽带帐号、固话号码及小灵通号码等)。
用户将该帐号与其互联星空帐号绑定后,中国电信可以代SP收费,并对收益分成。
支付
将用户使用收费服务所产生的费用扣除或累计的过程。
SSL(SecuritySocketLayer)
安全套接层,是面向连接的一种互联网应用层协议,用于通讯过程中保证客户端和服务端的数据完整性和保密性。
SOAP(SimpleObjectAccessProtocol)
简单对象访问协议,是Web服务技术的核心技术之一,用于Web服务调用的XML消息表示。
NTP(NetWorkTimeProtocol)
网络时钟协议。
3ChinaVnet互联星空计划介绍
以下从互联星空计划的内涵、市场定位及其服务的功能等方面进行简单介绍。
有关互联星空计划业务方面的介绍,详见《ChinaVnet互联星空业务规范书(试行)》。
3.1互联星空计划的内涵
充分利用中国电信的用户资源、网络资源、应用支撑平台资源、营销网络、客户服务和宣传渠道等资源,营造互联网产业良性发展的生态环境,积极推动互联网产业链的可持续发展,创造互联网服务新的商业模式,通过聚合SP的内容和应用,为中国电信互联网用户提供丰富多彩的信息应用服务,实现用户、ISP和SP的多方共赢。
3.2互联星空计划的市场定位
ChinaVnet互联星空业务是中国电信在互联网应用层面的业务,中国电信将通过自营和聚合SP的内容和应用向用户提供统一的基于中国宽带互联网的多样化、个性化的互联网内容和应用服务。
3.3互联星空计划服务的功能
ChinaVnet互联星空计划将实现“一点接入,全网服务”、“一点认证,全网通行”和“一点结算,全网收益”。
1)一点接入,全网服务
各SP可以通过接入中国电信集团公司或各省、直辖市公司的互联星空系统,实现向ChinaNet全网范围内的用户提供收费的内容和应用服务。
2)一点认证,全网通行
China互联星空用户只需要进行一次应用层认证,就可享受互联星空系统所有SP提供的内容和应用服务。
3)一点结算,全网收益
为使各SP方便地获取其全网性业务的收益,中国电信向SP提供单点结算服务。
3.4SP的分类
按SP的服务范围,可以将SP划分为以下两类:
●地方性SP。
与某个省签约的SP称为地方性SP。
地方性SP提供的内容服务只能供该省的互联星空用户访问,其服务目录信息可以在该省级中心的门户上展现。
●全国性SP。
与集团公司或代表集团公司的省公司签约的SP称为全国性SP。
全国性SP提供的内容服务可以供全国范围的互联星空用户访问,其服务目录信息可以在全国中心的门户上展现。
如果SP是与代表集团公司的省公司签约,则其服务目录信息也可以在该省的省级中心门户上展现。
按SP是否使用互联星空提供的计费功能,可以将SP划分为以下两类:
●自计费SP。
自计费SP由互联星空系统提供认证和代收费服务,SP负责提供应用服务内容并计费。
●代计费SP。
代计费SP由中国电信互联星空系统提供认证、计费和代收费服务,SP负责提供应用服务内容。
4接入功能及流程
4.1网络结构
SP通过ChinaNet连接到互联星空系统,网络结构示意图如下:
图4-1网络结构示意图
4.2认证处理
4.2.1一点认证的介绍
一点认证的定义详见第2章。
4.2.1.1登录方式
用户可以通过以下方式登录到互联星空:
1)用户在互联星空网站上点击“登录互联星空”的LOGO;
2)用户尚未登录,直接访问互联星空网站上的互联星空服务;
3)用户在SP网站上点击“登录互联星空”的LOGO;
4)用户尚未登录,直接访问SP网站上的互联星空服务。
5)用户通过中国电信的拨号客户端直接自动登录互联星空。
4.2.1.2认证令牌
互联星空系统通过使用UserToken和SPToken实现一点认证的功能。
UserToken和SPToken均为临时的身份凭证。
其中,UserToken由互联星空系统生成并颁发给用户,作为中国电信赋予用户的临时身份凭证,其中包含了用户的详细登录信息;
SPToken由SP系统根据互联星空系统提供的信息生成并颁发给用户,作为SP赋予用户的临时身份凭证,其中包含了用户的登录信息和在该SP上的授权信息。
当用户登录到互联星空后,互联星空平台根据用户信息生成并颁发UserToken。
当用户访问某个SP时,该SP系统如果不能辨别用户的身份,则通过重定向技术向互联星空平台提交身份验证请求,互联星空平台判断用户拥有合法的UserToken,则将相关信息返回给SP系统,SP系统生成并向用户颁发SPToken,并为之提供服务。
当用户再次访问该SP时,SP系统通过判断用户是否拥有SPToken,即可自行决定用户是否有权限使用收费服务。
4.2.1.3令牌的有效期
SPToken是一个临时的身份凭证,具有有效期属性,超过指定的时间后,SPToken不再有效。
此时SP系统需要在用户下一次访问其系统时再次向互联星空系统发出认证请求并根据认证结果生成新的SPToken。
同样,UserToken也是一个临时的身份凭证,具有有效期属性,当超过指定的时间后,UserToken不再有效。
互联星空系统需要再次验证用户的身份,以生成并颁发新的UserToken。
为使用户获得较好的使用体验,互联星空系统生成一个新的SPToken时,可以同时延长UserToken的有效期。
4.2.2流程描述
如果用户拥有有效的SPToken,当用户访问、消费服务时,SP系统可辨认用户的身份,直接进入支付流程。
以下讨论用户尚未拥有有效的SPToken,SP系统需要向互联星空系统提出认证请求的情况。
4.2.2.1首次登录
本流程适用于以下场景:
用户尚未获得有效的UserToken,此时访问SP网站。
图4-2首次登录流程示意图
1)用户请求使用互联星空服务;
2)SP通过重定向技术向省级中心提交认证请求(接口参见5.2.1);
3)省级中心显示登录页面;
4)用户提交身份验证信息;
5)省级中心将认证结果返回给SP系统;
6)SP系统向用户返回相应页面。
4.2.2.2后续登录
用户已经获得有效的UserToken,此时访问SP网站。
图4-3后续登录流程示意图
2)SP通过重定向技术向省级中心提交认证请求(接口参见5.2.1)
3)省级中心确认用户已经登录互联星空,直接将认证结果返回给SP系统;
4)SP系统向用户返回相应页面。
4.2.2.3用户退出
用户请求退出互联星空后,其本次登录所获得的临时身份凭证将全部失效,同时系统也将回收为用户提供服务的系统资源。
互联星空系统将通知用户登录后访问过的所有SP系统。
接收到用户的退出通知后,SP系统可以做相应的处理工作。
相关接口参见5.1.1。
4.3计费及支付处理
4.3.1概述
4.3.1.1服务模型定义
服务类型是指对不同收费内容的分类,如电影、音乐、游戏等。
服务项目是指某SP提供的收费内容,是面向用户并供用户定购和使用的实体,例如一首歌、一部电影。
服务项目属于某个服务类型,相同服务类型的服务项目使用相同的属性字段进行描述。
例如,不同的歌曲都具有主唱、作词、作曲、语言等属性。
服务项目可以是多个其它服务项目的集合,例如“2002年十大金曲”代表十首歌的集合,“70年代的歌”代表属于七十年代的所有歌的集合,它们都是一个服务项目。
服务是由某SP提供的一个或多个服务项目的集合,集合中的服务项目具有相同的资费定义。
例如:
“2002年十大金曲”和“70年代的歌”都在“2元包月歌集”服务中,包月定购其中任意一个服务项目都需要支付2元。
4.3.1.2计费/支付方式
互联星空业务需要支持以下计费/支付方式:
●包时段支付。
包时段收费是指用户支付一定金额,在指定的时间范围内可以任意使用指定的SP服务。
SP可以在此基础上将服务包装成包月或包季度等服务提供给用户。
用户可以指定该时段结束后,是否自动继续包等长的时段。
用户也可以取消继续包等长时段的设置。
●包次支付。
包次支付是指用户可以一次性购买某个互联星空服务的多次使用权。
用户每使用一次该互联星空服务,则其余下可使用次数减一。
当其可使用次数为零时,用户需要再次购买方可使用该服务。
●按次支付。
按次支付是指用户每使用一次服务,需要为之支付一次费用的支付方式。
●按时长计费/支付。
按时长计费/支付是指按照用户使用服务的时间长短进行计费/支付。
●按流量计费/支付。
按流量计费/支付是指按照用户使用服务所产生的流量大小进行计费/支付。
●离线支付。
离线支付是指由SP发起的扣除用户费用的过程。
此过程无需用户的直接确认。
4.3.2计费及支付流程
本节中提及的用户,如无特殊说明,均指已经通过身份认证的合法用户。
4.3.2.1按次收费方式
图4-4按次收费流程示意图
1)用户点击SP提供的互联星空服务;
2)SP系统通过重定向技术向其接入的省级中心发送按次购买请求(接口参见5.2.2);
3)SP接入的省级中心显示购买的详细信息(购买金额等),要求用户确认;
4)用户确认;
5)SP接入的省级中心向SP系统返回购买结果信息;
6)SP系统收到购买结果信息后向用户提供服务或显示错误页面;
7)SP向省级中心发送确认信息。
省级中心收到该信息后方可以正式扣费(接口参见5.2.11)。
4.3.2.2包时段收费方式
4.3.2.2.1包时段订购
图4-5包时段订购流程示意图
1)用户请求订购SP的包时段服务;
2)SP系统向其接入的省级中心发送包时段订购请求(接口参见5.2.3);
3)省级中心向用户显示详细的支付信息(支付金额等),要求用户确认;
5)省级中心向SP返回订购结果信息;
7)SP系统向省级中心发送确认信息。
4.3.2.2.2使用包时段服务
用户申请使用包时段服务时,SP根据SPToken的信息自行决定向用户提供服务,不需要与互联星空平台交互。
服务使用完毕后,SP向其接入的省级中心发送使用服务记录,发送接口和具体字段的取值请参见5.2.10。
4.3.2.2.3包时段服务订购的取消
包时段服务可以在使用过程中取消,相关费用根据协议规定的方法进行计算。
图4-6取消包时段订购服务流程示意图
1)用户在SP网站上选择取消包时段订购;
2)SP系统内部进行服务订购取消操作;
3)SP调用省中心提供的服务订购取消接口向接入省中心发送取消订购的通知(接口参见5.2.14);
4)接入省中心进行服务订购取消的内部处理;
5)接入省中心通知SP处理结果;
6)SP通知用户操作结果。
4.3.2.3包次收费方式
包次订购是指用户可以一次性购买某个互联星空服务的多次使用权。
用户每使用一次该互联星空服务,则其可使用次数减一。
4.3.2.3.1包次订购
流程同4.3.2.2.1。
4.3.2.3.2使用包次服务
图4-7使用包次服务流程示意图
1)用户在SP系统上提出使用包次服务申请;
2)SP系统向省中心发送包次服务支付请求(接口参见5.2.5);
3)SP接入的省级中心显示包次支付信息,要求用户确认;
6)SP系统收到购买结果信息后为用户提供相应的互联星空服务;
省级中心收到该信息后处理包次支付,更新用户剩余的可用次数(接口参见5.2.11)。
4.3.2.4按时长收费方式
为了支持预付费卡类支付手段以及用户的信用度控制,特设置锁定(续锁定)方式实现按时长计费服务。
其中,自计费型SP请求锁定金额;
代计费型SP请求锁定时长,计费由互联星空系统实现。
图4-8按时长收费流程示意图
1)用户请求使用SP的按时长计费服务;
2)SP通过重定向技术发送锁定请求(接口参见5.2.6);
3)SP接入的省级中心显示该服务的费率信息,提示用户确认;
5)省级中心返回锁定结果;
6)在用户的使用过程中,如果锁定额度已经用尽,SP系统发送续锁定请求,该请求同时表示对上一个锁定的确认,即省级中心可以扣除上一个锁定请求锁定的费用(接口参见5.2.7);
7)省级中心返回续锁定结果(第6和第7步可以多次出现);
8)当用户使用完毕后,SP系统发送按时长计费/支付请求,将最后一次锁定后发生的使用时长(或金额)通知省级中心(接口参见5.2.9);
9)SP接入的省级中心向SP系统返回请求处理结果。
4.3.2.5按流量收费方式
为了支持预付费卡类支付手段以及用户的信用度控制,特设置锁定(续锁定)方式实现按流量计费服务。
代计费型SP请求锁定流量,计费由互联星空系统实现。
图4-9按流量收费流程示意图
1)用户请求使用SP的按流量计费服务;
8)当用户使用完毕后,SP系统发送按流量计费/支付请求,将最后一次锁定后发生的使用流量(或金额)通知省级中心(接口参见5.2.8);
4.3.2.6离线收费方式
离线支付适用于以下的应用场景:
●包时段订购服务的续订购;
●先体验、后支付类服务的支付。
离线支付的应用条件:
●经互联星空中心许可的离线支付资质;
●提供离线支付方式的服务的首个定购过程须采用在线支付方式,需要用户确认此项服务可以采用离线支付方式对续定购扣费;
●用户在SP发起首个离线支付前可以取消续定购;
●对于提供离线支付方式的包时段服务,在包时段结束后提供服务免费使用延长期,延长期内若用户未取消定购则仍允许用户享受服务,延长期过后才允许SP未续定购发送离线支付请求。
4.4客户端软件的接入
如果SP提供的服务是基于特定客户端软件的,且该客户端软件不适合做相应的修改(例如国外游戏软件),则使用该类型客户端软件的用户不能享受一点认证的服务。
否则,通过修改客户端软件,使其支持浏览器功能,并遵循相关规范,则可使用户享受到一点认证的服务。
使用客户端软件的服务可以通过网站购买的方式实现代收费。
以基于客户端软件的游戏为例,用户访问SP网站,选择网站上提供的购买游戏点数的按次收费服务,互联星空系统为其收取该服务的费用,SP系统负责将该点数转入到对应游戏帐号中。
例如,用户登录互联星空后,点击服务名为“购买游戏点数100点,资费:
每次2元”的服务,则互联星空系统将该费用累计到其支付帐号中,实现代收费。
SP系统需要自行将100点存入用户指定的游戏帐号中。
在整个过程中互联星空系统不与客户端软件发生交互。
4.5对帐
在帐期内第N天时的规定时间,SP系统与其接入的互联星空系统核对第(N-2)天的帐。
对中国电信所有互联星空用户使用该SP提供的服务所产生的费用记录进行核对。
具体方式为:
SP上传总帐,如果误差在规定的比例内,则以中国电信的数据为准;
否则SP上传明细帐,互联星空系统下发明细帐差异结果,进行人工处理。
4.6结算
每个结算周期结束后,SP与其接入的省级中心进行“一点结算”。
具体结算办法请参看《ChinaVnet互联星空业务规范书(试行)》。
4.7时钟同步
SP系统的服务器需要按照中国电信的要求,与指定的国际标准NTP服务器每日同步。
5接口
互联星空平台根据其预先保存的SP系统IP地址以及颁发给SP的密钥来辨认SP系统的身份。
以下定义的接口需要遵循如下规定:
1)本规范接口的所有数据类型定义均遵循XML语言定义规范(W3C2001版规范,详见http:
//www.w3.org/2001/XMLSchema);
2)对于重定向接口中的字符串参数,必须进行控制码的转义。
方法为UrlEncoding(Str),其具体实现参见RFC1738。
3)对于重定向接口,定义#为返回参数与ReturnUrl之间的连接符变量,如果ReturnUrl中包含查询参数,#取值为“&
”,否则取值为“?
”。
4)对于非重定向接口,通过WebService实现。
对WebService的调用采用SOAP调用方法。
SOAP接口若无特殊说明,均承载在HTTP协议上。
承载SOAP调用的HTTP请求头中使用POST命令。
本规范不对其目的地址的URL作具体规定。
5)两个实体间通过统一的WebService完成各SOAP方法的调用。
互联星空系统向SP系统提供的接口方法都封装在一个WebService中。
6)对于SOAP调用接口,服务提供方必须首先检查服务请求方的IP地址的合法性方可提供服务。
7)所有SOAP调用的XML编码均采用UTF-8方式;
8)所有SOAP调用方法的URL均作为SOAPAction的取值。
9)为了保证接口未来的平滑升级,所有接口方法的URL均需要包含版本信息,且URL的大小写不敏感。
10)3DES算法中,InitialVector取值为零。
11)接口描述中的斜体部分表示变量在系统运行中的实际取值。
12)本规范中的接口若无特殊说明,均为同步调用接口。
13)ChinaVnetCenter是指相关互联星空系统的名字空间,组成形式是。
其中,xx是省份标识,例如广东省为gd。
其他省份标识详见附录1。
14)SPCenter是指接入互联星空系统的SP系统的域名,该域名由SP指定。
15)本规范定义的使用重定向的接口中,不特别指定对应的处理页面的类型,只定义对应处理页面的名称,如登录页面,只定义为login;
对于jsp页面,应补全为login.jsp,对于asp页面,应补全为login.asp,以此类推。
16)对于采用HTTPS的接口,只要求检查服务器端的证书,不要求检查客户端的证书。
5.1SP系统提供的接口
5.1.
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 星空 技术规范 SP 系统 接口 分册 V12