中国联通增值业务鉴权中心接口规范VAC与SP接口规范1218重点.docx

《中国联通增值业务鉴权中心接口规范VAC与SP接口规范1218重点.docx》由会员分享，可在线阅读，更多相关《中国联通增值业务鉴权中心接口规范VAC与SP接口规范1218重点.docx（12页珍藏版）》请在第一文库网上搜索。

1、新SPMS上线后需要SP与VAC平台连接，请进行接口开发I、按照附件进行接口开发，2009年2月20日前与爱立信VAC平台进行联调。厂家温工.2、原有接口不动，保证现有业务正常使用.中国联通公司企业标准OB/CU 中国联通VAC平台接口技术要求：VAC与SP接口规范(暂定名)(VI. 1) - - X发布XXXX-XX-XX 实施中国联通公司发布修改记录II前 言III1范围42规范性引用文件43定义与缩略语43.1 定义43.2 缩略语43.3 信息更新时机定义54 VAC和SP间的接口 54.1 定购通知接口 5接口描述5发起方系统5接受方系统5接口协议5接口内容5订购关系通知 SP 请求

2、(OrderRelationUpdateNotifyReq) 5订购关系通知 SP 响应(OrderRelationUpdateNotifyRsp) 64.2定购关系同步接口 6接口描述6发起方系统7接受方系统7接口协议7接口内容7请求文件头(定长) 7文件体7过渡阶段定制关系变更通知SP通用流程8修改记录文件编号版本号拟制人/修改人拟制/修改口期更改理由主要更改内容（写要点即可）封面VI.12008-12-18版本号修改从1.0改为1.1增加本节注1：每次更改归档文件时，需填写此表。注2：文件第一次归档时，“更改理由”、“主要更改内容”栏写“无本标准是中国联通增值业务鉴权中心系列标准之一，本

3、系列标准的预期结构如下:中国联通增值业务鉴权中心（VAC）技术体制本标准将根据业务的开展情况与市场需求，适时进行修改。本标准由中国联通公司增值业务部提出。本标准由中国联通公司技术部归口。本标准主要起草单位：中讯邮电咨询设计院，中国联通增值业务部本标准主要起草人：XXX本标准的修改和解释权属中国联通公司。中国联通增值业务鉴权中心接口技术要求：VAC平台与SP接口规范（V1. 1）1范围本标准规定了中国联通VAC与SP之间的接口。适用于联通、省分公司和厂家进行VAC和SP系统互联建设的研制、开发和实施，是中国联通VAC、SP接入规划和建设的基本依据。2规范性引用文件下列文件中的条款通过本标准的引用

4、而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注口期的引用文件，其最新版本适用于本标准。3定义与缩略语3.1定义本标准采用以下定义：1）业务：业务是一定的内容和/或服务能力的聚合。业务名称是用户用以识别不同的增值.业务的标识。在管理上，业务是服务提供商与运营商进行审核管理和分成结算的对象。如“新浪酷图”业务。2）业务能力：指基础增值服务，例如：邮件、消息、浏览、流媒体等，可以使用这些业务能力进行组合，构造出特定的业务，满足细分市场后的用户需求。3）业务引擎：指实

5、现各个业务能力的物理实体。4）产品：产品是对业务的标价，是用户购买业务的方式，即用户使用业务所需要支付的价钱、支付的方式、以及其能够获得的使用额度。在VAC系统中，产品是订购、鉴权、和计费的对象，如“包月5元”。一个业务对应多个产品，一个产品唯一对应一个业务。5）内容：内容是用户真正使用的对象，是在业务中提供的一个个实体，如“手机酷图”业务中的一个图片。6）门户：指直接面对用户的界面。增值业务鉴权中心通过多种承载形式提供给用户多样化的操作能力，如业务订购、取消、查询、导购、帮助等。基于不同的承载形式，门户可以包括WAP门户、WEB门户、短信门户和语音门户。3.2 缩略语本标准采用以下缩略语：V

6、AC Value-added Service Platform增值业务鉴权中心AAAAuthentication Authorization Account认证授权计费BrewBinary Runtime Environment for Wireless无线二进制运行环境CDMACode Division Multiple Access码分多址DMDevice Management设备管理DRMDigital Right Management数字版权管理IMInstant Massage即时消息GSMGlobal System for Mobi1e communication全球移动通信系统G

7、PRSGeneral Packet Radio Service通用无线分组业务LCSLocation Services定位业务MMSMultimedia Messaging Service多媒体消息服务OTAOver the Air空中下载PIMPersonal Information Management个人信息管理PoCPTT over the Cellular基于蜂窝网的PTT业务PTTPush to Talk一按即说SLAService Level Agreement服务品质协议SPService Provider服务提供商SSGService Select Gateway业务选择网关

8、TTSText-To-Speech文本语音转换WAPWireless Application Protocol无线应用协议3.3 信息更新时机定义-对于新增的CP/SP,当第一次转为测试状态，第一次转为商用状态时，分别需要更新一次;-对于已有CP/SP,信息发生变化时，需要更新；除以上两种情况外，BSS不能向VAC传递CP/SP信息。4 VAC和SP间的接口4.1 定购通知接口4.1.1 接口描述用户订购关系发生变化时以及用户点播SP业务时，VAC通过此接口实时通知SP。批开、批退时不采用此接口通知SP,通过FTP订购关系同步接口通知SP。通知失败时，根据配置，VAC可进行重试，重试失败则记录

9、日志，之后通过FTP订购关系同步接口进行补偿。为减少SP改造的工作量，保留原联通在信平台SGTP与WAP平台（总部）Http两种通知SP的方式，SP可以从三种方式中选择任意一种。4.1.2 发起方系统VACo4.1.3 接受方系统SPo4.1.4 接口协议该接口采用Web Service方式。4.1.5接口内容4. 1.5. 1 订购关系通知 SP 请求(OrderRe I at i onUpdateNot i fyReq)参数名类型大小描述RecordSequencelDstring18流水号，UserldTypeinteger4用户ID类型1: MSISDN2: PsedoCodeUser

10、idstring36用户手机号码或伪码UserldType填1为手机号码UserldType填2为伪码ServiceTypeString2业务类型,见附录Spldstring21SP标识Productldstring21产品标识（此为SP在PRM侧申请的SP_Productid）UpdateTypeinteger4更新操作的类型包括：1：订购2：取消订购3：点播UpdateTimestring14更新时间UpdateDescstring100更新操作的详细描述，默认为空LinklDstring20事务关联ID,用于点播业务的临时定购关系关联，由平台产生。格式如下：MMDDHHMMSS+10位随

11、机序列号；为空表示无效。用户点播时使用。Contentstring140内容Effective Datestring14订购关系生效时间，格式：yyyyMMddhhmmssExpireDatestring14订购关系失效时间，格式：yyyyMMddhhmmss4. 1.5. 2 订购关系通知 SP 响应(OrderRe I at i onUpdateNot i f yRsp)参数名类型字节大小描述RecordSequencelDstring18流水号，与OrderRelationUpdateNoMfyReq 的流水号相同ResultCodeinteger4结果识别码0:成功1.失败4.1.5

12、2定购关系同步接口4.2.1 接口描述该接口用于VAC与SP每天稽核增量订购关系。包括批量定购和退订。VAC将每天增量文件放到VAC为SP提供的文件服务器的目录下。双方通过文件传输实现接口。文件服务器上设定具有对相应目录存取权限的用户。VAC为SP分配具有读写文件权限的用户和密码。系统于每天凌晨1： 00进行稽核文件资料同步。资料同步周期应具有根据最新规定进行可调的能力。文件采用ASC文本格式,各属性间使用t,分隔，在生成记录时若相应的属性值为空，直接用分隔符隔开，分隔符之间无其他符号。文件体中一行作为一条记录，各条记录之间用换行符n作为分隔并在文件中连续书写。文件头定长，文件体不定长。文件的

13、维护由VAC负责。4.2.2 发起方系统VACo4.2.3 接受方系统SPo4.2.4 接口协议FTP文件。4.2.5 接口内容文件目录根目录VACSubscri beTnfo文件命名：SubscribeInfo+SPID+yyyyMMddHHmm+xxx+nnnn. txtSPID八位,不足八位,左补零文件产生的时间（12位yyyyMMddHHmm精确到年月日时分）xxx为省分代码。nnnn是4位序列号，每天从“0001”开始，到达“ 9999”后又从“0001”开始。4.2.5.1请求文件头（定长）序号属性名长度备注1文件序列号（流水号）CHAR(4)0001开始,排满9999后重新循环2版本信息CHAR(5)缺省：000003文件产生时间CHAR(14)yyyymmddhhmmss4文件生成方系统代码CHAR(3)9025记录开始日期时间CHAR(14)yyyymmddhhmmss6记录结束口期时间CHAR(14)yyyymmddhhmmss7总记录数CHAR(10)8备用CHAR(40)9换行CHAR(1)4.2.5.2文件体参数名类型大小描述RecordSequencelDstring18流水号，UserldTypeinteger