某通信公司技术规范外部接口分册

中国移动省级NG2-BASS3.0技术规范外部接口分册

08一月2023

目录1、总体说明3、互动接口2、数据源接口4、功能接口接口规范目标1统一规范省级经营分析系统和源系统之间的连接关系和接口特性，规范各数据单元的接口格式6降低省级经营分析系统和源系统间数据接口的建设风险和难度，保障数据接口的建设进度4减少省级经营分析系统与源系统之间的相互影响，保障生产系统的稳定安全5采用数据封装机制，统一规范省级经营分析系统向各外部系统提供信息服务的标准和接口内容2继续扩充数据源接口内容，如中央业务类接口。3要求实现准实时接口，以提升外部系统数据导入的准实时性，为外部系统提供准实时性的数据访问，提高数据获取和数据访问的准实时性服务能力。接口规范原则在满足业务需求的前提下，使接口数据量最少，最大限度地减轻数据提供方压力保证省级经营分析系统与外部系统数据一致性具有可靠完善的接口数据传输与错误处理机制互动接口应符合开放系统的标准协议应具备完整性、规范性、开放性和灵活性互动接口应能够平滑地扩充互动接口连接必须具有安全控制机制接口定义遵循易理解、易使用、易交流、易扩展的原则扩展原则：由数据源传送方或数据源接收方发起的接口扩展，都必须采用现有的传输协议与模式，并与现有接口编码规则和命名规则保持一致编制原则：接口定位接口分类省级经营分析系统与外部系统的接口包括以下三类：数据源接口：是省级经营分析系统从外部系统获取数据的接口互动接口：是省级经营分析系统为外部系统提供数据信息的接口功能接口：主要包括省级经营分析系统与4A安全平台接口、信息推送接口目录1、总体说明3、互动接口2、数据源接口4、功能接口接口数据来源直接从省级业务支撑系统获取相关数据，如省级NG1-BOSS、NG1-CRM；直接从省级外部数据源系统，如：网管系统、彩铃平台、DSMP平台、OTA平台、WAP网关、网络信令采集子系统、VGOP平台、ERP/MIS系统等获取相关数据；间接通过省级VGOP系统获取一类业务数据：中央音乐平台/无线音乐平台

、手机报平台、飞信平台、号薄

管家平台、DM平台、手机视频平台、手机阅读、手机游戏、PUSHEMAIL、手机支付、12580综合信息平台等的相关数据。间接通过省级VGOP系统获取二类业务数据间接通过一级经营分析系统获取：新业务营销体验平台、行业应用终端监控平台的相关数据。接口编码原则

接口单元类别名称类别代码字冠接口单元类别名称类别代码字冠客户管理01财务92客户服务02网络信令接口94成员管理03OTA平台接口95资源管理04中央业务类96计费帐务05网管接口97结算06彩铃98营销与市场调查07DSMP99参数配置与计算原则08

接口单元的编码单元类别代码二位数字序列号三位数值各接口单元的编码规则是：

<单元类别代码字冠>

<序列号>

96中央央业业务务类类接接口口单单元元96中央央业业务务类类接接口口增增加加了了一一级级VGOP作为为源源系系统统的的部部分分接接口口，，4个新新的的业业务务平平台台手手机机阅阅读读、、手手机机游游戏戏、、PUSHEMAIL、手手机机支支付付、、手手机机视视频频；；修修改改部部分分接接口口包包括括：：飞飞信信业业务务平平台台接接口口、、12580平台台接接口口、、终终端端平平台台接接口口等等。。原手手机机电电视视接接口口停停止止，，变变更更为为手手机机新新增增的的手手机机视视频频接接口口。。依据据：：原原手手机机电电视视接接口口内内容容，，就就是是现现在在的的手手机机视视频频接接口口内内容容，，因因此此跟跟进进一一级级VGOP给经经分分的的手手机机视视频频接接口口进进行行增增补补。。92财务务类类接接口口单单元元本次次规规范范新新增增财财务务类类接接口口。。具具体体包包括括：：广广告告成成本本、、宣宣传传成成本本、、通通信信网网运运营营成成本本、、营营销销机机构构成成本本、、销销售售费费用用、、管管理理费费用用六六个个接接口口。。94网络络信信令令接接口口单单元元停止止了了94001———94008接口口；；对对原原有有的的94009A接口口做做了了增增加加和和修修订订，，同同时时新新增增了了94010Gb信令令接接口口。。01客户户管管理理接接口口单单元元01客客户户管管理理接接口口增加加：：01036帐帐户户关关系系01037家家庭庭客客户户01038家家庭庭客客户户成成员员01039订订购购实实例例;01040校园园基基本本信信息息01041学校校管管理理层层信信息息01042学生生信信息息01043教职职工工信信01044学生生放放号号类类营营销销活活动动目目标标客客户户信信息息；；修订订接接口口：：01009帐帐本本，，增增加加““上上期期结结余余””；；02客户户服服务务接接口口单单元元未做做修修订订03员工工接接口口单单元元未做做修修订订04资源源管管理理类类接接口口单单元元修订订：：在在终终端端设设备备接接口口中中补补充充终终端端类类别别属属性性字字段段；；05计费费帐帐务务接接口口单单元元未做做修修订订06结算算接接口口单单元元未做修订订07-营销与市市场调查查接口单单元未做修订订08-参数配置置与计算算原则接接口单元元新增接口口：08118打包产品品构成，，修订：：08015终端设备备类别准实时数数据源接接口能力力支撑经营分析析系统数数据源接接口的传传送周期期需满足足月、日日、小时时和分钟钟等多种种周期。。对于准准实时数数据源接接口内容容不同，，对标准准化传输输的周期期的迫切切不同，，本期规规范要求求数据源源准实时时接口支支持到小小时。准实时数数据源接接口的数数据获取取最终取取决源系系统的系系统提供供能力。。具体内内容参见见技术规规范总册册相关章章节。准实时数数据源接接口单元元列表5001语音清单用户使用

GSM/TD业务清单，含GSM/TD国际漫游来访清单计费帐务类5002GPRS清单用户使用

GPRS业务清单，含GPRS国际漫游来访清单计费帐务类5003移动梦网短信清单用户使用移动梦网短信业务清单计费帐务类5004移动梦网

WAP清单用户使用移动梦网

WAP业务清单计费帐务类5005普通短信清单用户使用普通点对点短信业务清单计费帐务类5009智能网

VPMN清单用户使用智能网

VPMN业务的清单计费帐务类5016互联互通短信清单用户互联互通服务使用记录计费帐务类5018MMS清单用户使用彩信服务记录计费帐务类目录1、总体说明3、互动接口2、数据源接口4、功能接口互动接口口总表服务名称数据集接口单元说明

信息交互方式分类名称营销服务互动服务营销互动营销活动配置对一个具体的营销与服务活动进行概括描述的接口

。发布－订阅方式营销活动目标客户规则指营销活动中需要选择的目标客户群过滤的规则信息。发布－订阅方式营销活动目标客户指营销活动所选择的营销目标客户群的信息。发布－订阅方式活动触发规则用于全程精确营销信令实时匹配的各种参数规则接口

。发布－订阅方式活动执行区域指营销活动执行所覆盖的区域信息。发布－订阅方式资费产品推荐互动资费产品推荐通过客户细分、资费预演等专题分析，形成资费产品推荐信息。发布－订阅方式客户关怀互动客户挽留名单通过数据挖掘方法预测可能流失的客户，形成客户挽留名单信息。发布－订阅方式客户关怀信息通过客户细分模型等数据挖掘方法，对客户群体进行细分。发布－订阅方式策反互动策反方案信息通过分析潜在客户的消费行为、消费能力等轮廓信息生成策反方案。发布－订阅方式互动接口口总表（（续）分析结果查询服务分析结果查询业务历史数据分析结果数据集该接口用于经营分析系统向外部系统提供历史报表访问。在线请求—异步响应方式明细数据查询明细数据结果数据集该接口用于经营分析系统向外部系统提供详细数据访问。在线请求—异步响应方式客户统一视图服务客户统一视图获取个人客户基本属性信息该接口用于获取指定的个人客户的基础属性相关信息，包括基本属性、终端使用、终端功能属性等。在线请求—同步响应方式获取个人客户分析属性信息该接口用于获取指定的个人客户分析属性信息，包括客户行为属性、增值业务营销属性等。在线请求—同步响应方式获取客户标签属性信息该接口用于查询客户对应的客户标签信息。在线请求—同步响应方式获取客户数据及信息业务特征信息该接口用于获取客户使用数据及信息业务的行为特征信息。在线请求—同步响应方式获取集团客户分析属性信息方法该接口用于获取集团客户行为、产品、应用等特征信息。在线请求—同步响应方式获取集团成员分析属性信息方法该接口用于获取集团成员行为等特征信息。在线请求—同步响应方式本数据服服务的数数据集及及6个方法支支撑对外外部准实实时数据据提供的的需求，，“在线线请求-同步响应应”的消消息交换换模式即即是准实实时的，，我们采采用此交交互模式式，提高高数据请请求、数数据查询询、数据据返回各各个环节节的效率率，以达达到准实实时数据据支撑的的能力。。具体技技术实现现方式参参见技术术规范总总册“准准实时数数据提供供章节””描述。。营销服务务互动服服务营销服务务互动服服务的信信息交换换方式采采用发布布－订阅阅方式。。营销服服务互动动服务中中的注册服务务由服务提供供方提供，通知服务务由服务请求求方提供。支支持营销销服务互互动服务务数据集集有营销销互动、、资费产产品推荐荐互动、、客户关关怀互动动、和策反互互动等。。服务标识识PublishSubscibeService服务描述述注册服务务由服务务提供方方提供。。服务请请求方调调用注册册服务，，用于起起订或退订具具体的服服务。注注册服务务支持的的数据集集有营销销互动、、资费产产品推荐荐互动、、客户关关怀互动动、和策策反互动动等。在注册服服务的WSDL服务描述述中需要要列出可可订阅数数据集信信息。实现方式式基于SOAP的Web服务。性能要求求单次请求求正常网网络通讯讯情况下下，响应应时间必必须在2秒之内；；同一时时间内支支持的最最大并发发请求小小于100。方法标识识RegisterRequest方法描述述服务请求求方调用用注册服服务（PublishSubscibeService）的注册册方法（（RegisterRequest），并发发送请求求消息给给服务提提供方。。服务提提供方订订阅操作作完毕，，并返回回应答消消息给服服务请求求方。通知服务务服务标识识通知服务务标识是是由服务务请求方方在填写写注册服服务的请请求信息息中定义义的。它它是由注注册服务务（PublishSubscibeService）的注册册方法（（RegisterRequest）的请求求消息中中定义的的通知服服务标识识（ServiceID）指定的的。服务描述述通知服务务由服务务请求方方提供。。服务提提供方准准备完数数据，通通过调用用通知服服务，告告诉服务请求求方数据据准备完完毕。通通知服务务支持的的数据集集有营销销互动、、资费产产品推荐荐互动、、客户关关怀互动动、和策策反互动动等。实现方式式基于SOAP的Web服务。性能要求求单次请求求正常网网络通讯讯情况下下，响应应时间必必须在2秒之内；；同一时时间内支支持的最最大并发发请求小小于100。方法标识识通知服务务方法标标识是由由服务请请求方在在填写注注册服务务的请求求信息中中定义的的。。它是由注注册服务务（PublishSubscibeService）的注册册方法（（RegisterRequest）的请求求消息中中定义的的通知服服务方法法标识（（FunctionID）指定的的。方法描述述服务提供供方数据据准备完完毕后，，调用服服务请求求方提供供的通知知服务方方法并传传递请求求消息。。服务请请求方接接收到通通知，返返回应答答消息给给服务提提供方。。获取客户户统一视视图服务务的新增增内容在获取客客户统一一视图服服务增增加两个个新的方方法：获取集团团客户分分析属性性信息方方法获取集团团成员分分析属性性信息方方法请求消息息获取集团团客户分分析属性性信息方方法获取集团团客户分分析属性性信息方方法应答消息息目录1、总体说明3、互动接口2、数据源接口4、功能接口功能接口口类别表表类别代码接口单元一级类别名称说明01省级经营分析系统与安全平台接口主要实现省级经营分析系统与安全平台对接的接口，如：从帐号登录、从帐号查询、角色查询、从帐号变更、角色变更、从帐号权限查询等接口02信息推送接口省级经营分析系统通过短信推送接口，彩信推送接口和邮件推送接口功能模块并通过外部网关及服务器发送给用户的信息推送类接口。如：短信推送、彩信推送、邮件推送接口。省级经营营分析系系统与4A安全平台台接口从帐号登登录：通过改造造经营分分析系统统的认证证管理模模块、数数据安全全管理模模块来实实现4A管理平台台与经营营分析系系统之间间的单点点登录（（SSO）、集中中认证，，接收请请求并返返回认证证结果；；从帐号查查询：通过改造造经营分分析系统统的用户户管理模模块、数数据安全全管理模模块来实实现4A管理平台台对经营营分析系系统中从从帐号及及属性的的查询；；角色查询询：通过改造造经营分分析系统统的用户户管理模模块、数数据安全全管理模模块来实实现4A管理平台台对经营营分析系系统中角角色及属属性的查查询；从帐号变变更：通过改造造经营分分析系统统的用户户管理模模块、数数据安全全管理模模块来实实现4A管理平台台对经营营分析系系统中从从帐号及及属性的的变更、、同步；；角色变更更：通过改改造经经营分分析系系统的的用户户管理理模块块、数数据安安全管管理模模块来来实现现4A管理平平台对对经营营分析析系统统中角角色及及属性性的变变更、、同步步；从帐号号权限限查询询：通过改改造经经营分分析系系统的的权限限管理理模块块、数数据安安全管管理模模块来来实现现4A管理平平台对对经营营分析析系统统中从从帐号号角色色关系系、从从帐号号细粒粒度权权限的的查询询；角色权权限查查询：：通过改改造经经营分分析系系统的的权限限管理理模块块、数数据安安全管管理模模块来来实现现4A管理平平台对对经营营分析析系统统中角角色的的权限限的查查询；；从帐号号角色色变更更：通过改改造经经营分分析系系统的的权限限管理理模块块、数数据安安全管管理模模块来来实现现4A管理平平台对对经营营分析析系统统中从从帐号号的角角色关关系变变更、、同步步；从帐号号权限限变更更：改造经经营分分析系系统的的权限限管理理模块块、数数据安安全管管理模模块，，实现现通过过4A管理平平台对对经营营分析析系统统中从从帐号号细粒粒度权权限变变更；；审计日日志传传送：：通过改改造经经营分分析系系统的的审计计日志志记录录和数数据安安全管管理模模块来来实现现4A管理平平台对对经营营分析析系统统中登登录记记录和和关键键操作作记录录的过过滤、、格式式化和和发送送。信息推推送接接口短信推推送接接口功功能短信推推送接接口功功能模模块负负责通通过CMPP协议与与短信信网关关交互互，使使经营营分析析门户户的信信息以以短信信方式式发送送给用用户。。短信信通知知接口口支持持短信信的群群发与与定时时发送送，传传输的的内容容包括括发送送流水水号、、手机机号码码、发发送时时间、、发送送内容容、校校验等等。短短信推推送接接口功功能模模块应应有完完善的的系统统出错错处理理机制制，避避免短短信的的漏发发、错错发，，系统统将对对没有有发送送成功功的信信息进进行缓缓存并并进行行多次次重发发。彩信推推送接接口功功能彩信推推送接接口功功能负负责与与彩信信网关关交互互，使使经营营分析析门户户可以以把信信息以以彩信信方式式发送送给用用户。。彩信信推送送接口口传输输内容容包括括流水水号、、手机机号码码、发发送时时间、、彩信信主题题、图图片长长度、、图片片数据据、文文本长长度、、文本本内容容、音音频长长度、、音频频内容容等。。邮件推推送接接口功功能邮件通通知接接口负负责与与经营营分析析门户户外的的邮件件服务务器交交互，，使得得经营营分析析门户户可以以把信信息以以邮件件方式式通过过邮件件服务务器发发出，，应支支持SMTP等协议议。谢谢！！9、静夜四四无邻，，荒居旧旧业贫。。。12月-2212月-22Thursday,December29,202210、雨中黄叶叶树，灯下下白头人。。。14:40:0014:40:0014:4012/29/20222:40:00PM11、以以我我独独沈沈久久，，愧愧君君相相见见频频。。。。12月月-2214:40:0014:40Dec-2229-Dec-2212、故人江海别别，几度隔山山川。。14:40:0014:40:0014:40Thursday,December29,202213、乍见翻疑梦梦，相悲各问问年。。12月-2212月-2214:40:0014:40:00December29,202214、他乡乡生白白发，，旧国国见青青山。。。29十十二二月20222:40:00下下午14:40:0012月月-2215、比不了得得就不比，，得不到的的就不要。。。。十二月222:40下下午12月-2214:40December29,202216、行动出出成果，，工作出出财富。。。2022/12/2914:40:0014:40:0029December202217、做前，能能够环视四四周；做时时，你只能能或者最好好沿着以脚脚为起点的的射线向前前。。2:40:00下下午2:40下下午14:40:0012月-229、没有有失败败，只只有暂暂时停停止成成功！！。12月月-2212月月-22Thursday,December29,202210、很很多多事事情情努努力力了了未未必必有有结结果果，，但但是是不不努努力力却却什什么么改改变变也也没没有有。。。。14:40:0014:40:0014:4012/29/20222:40:00PM11、成成功功就就是是日日复复一一日日那那一一点点点点小小小小努努力力的的积积累累。。。。12月月-2214:40:0014:40Dec-2229-Dec-2212、世间成事事，不求其其绝对圆满满，留一份份不足，可可得无限完完美。。14:40:0014:40:0014:40Thursday,December29,202213、不知香积寺寺，数里入云云峰。。12月-2212月-2214:40:0014:40:00December29,202214、意志志坚强强的人人能把把世界界放在在手中中像泥泥块一一样任任意揉揉捏。。29十十二二月20222:40:00下下午14:40:0012月月-2215、楚塞塞三湘湘接，，荆门门九派派通。。。。十二月月222:40