1、中国移动省级NG2-BASS3.0技术规范外部接口分册16八月2019目录目录1 1、总体说明、总体说明3 3、互动接口、互动接口2 2、数据源接口、数据源接口4 4、功能接口、功能接口接口规范目标接口规范目标1统一规范省级经营分析系统和源系统之间的连接关系和接口特性，规范各数据单元的接口格式6降低省级经营分析系统和源系统间数据接口的建设风险和难度，保障数据接口的建设进度4减少省级经营分析系统与源系统之间的相互影响，保障生产系统的稳定安全5采用数据封装机制，统一规范省级经营分析系统向各外部系统提供信息服务的标准和接口内容2继续扩充数据源接口内容，如中央业务类接口。3要求实现准实时接口，以提升外
2、部系统数据导入的准实时性，为外部系统提供准实时性的数据访问，提高数据获取和数据访问的准实时性服务能力。接口规范原则接口规范原则在满足业务需求的前提下，使接口数据量最少，最大限度地减轻数据提供方压力 保证省级经营分析系统与外部系统数据一致性 具有可靠完善的接口数据传输与错误处理机制 互动接口应符合开放系统的标准协议 应具备完整性、规范性、开放性和灵活性互动接口应能够平滑地扩充 互动接口连接必须具有安全控制机制 接口定义遵循易理解、易使用、易交流、易扩展的原则 扩展原则：扩展原则：由数据源传送方或数据源接收方发起的接口扩展，都必须采用现有的传输协议与模式，并与现有接口编码规则和命名规则保持一致 编
3、制原则：编制原则：接口定位接口定位接口分类接口分类 省级经营分析系统与外部系统的接口包括以下三类：数据源接口：是省级经营分析系统从外部系统获取数据的接口 互动接口：是省级经营分析系统为外部系统提供数据信息的接口 功能接口：主要包括省级经营分析系统与4A安全平台接口、信息推送接口目录目录1 1、总体说明、总体说明3 3、互动接口、互动接口2 2、数据源接口、数据源接口4 4、功能接口、功能接口接口数据来源接口数据来源 直接从省级业务支撑系统获取相关数据，如省级NG1-BOSS、NG1-CRM；直接从省级外部数据源系统，如：网管系统、彩铃平台、DSMP平台、OTA平台、WAP网关、网络信令采集子系
4、统、VGOP平台、ERP/MIS系统等获取相关数据；间接通过省级VGOP系统获取一类业务数据：中央音乐平台/无线音乐平台、手机报平台、飞信平台、号薄管家平台、DM平台、手机视频平台、手机阅读、手机游戏、PUSHEMAIL、手机支付、12580综合信息平台等的相关数据。间接通过省级VGOP系统获取二类业务数据间接通过一级经营分析系统获取：新业务营销体验平台、行业应用终端监控平台的相关数据。接口编码原则接口编码原则 接口单元接口单元的编码的编码单元类别代码单元类别代码 二位数字二位数字序列号序列号三位数值三位数值各接口单元的编码规则各接口单元的编码规则是：是：9696中央业务类接口单元中央业务类接
5、口单元p96中央业务类接口增加了一级VGOP作为源系统的部分接口，4个新的业务平台手机阅读、手机游戏、PUSHEMAIL、手机支付、手机视频；修改部分接口包括：飞信业务平台接口、12580平台接口、终端平台接口等。p原手机电视接口停止，变更为手机新增的手机视频接口。依据：原手机电视接口内容，就是现在的手机视频接口内容，因此跟进一级VGOP给经分的手机视频接口进行增补。9292财务类接口单元财务类接口单元p本次规范新增财务类接口。具体包括：广告成本、宣传成本、通信网运营成本、营销机构成本、销售费用、管理费用六个接口。9494网络信令接口单元网络信令接口单元p停止了9400194008接口；对原有
6、的94009 A接口做了增加和修订，同时新增了94010 Gb信令接口。0101客户管理接口单元客户管理接口单元p 01客户管理接口 增加：01036 帐户关系 01037 家庭客户 01038 家庭客户成员 01039 订购实例;01040 校园基本信息 01041 学校管理层信息 01042 学生信息 01043 教职工信 01044 学生放号类营销活动目标客户信息；修订接口：01009帐本，增加“上期结余”；0202客户服务接口单元客户服务接口单元p未做修订0303员工接口单元员工接口单元p未做修订0404资源管理类接口单元资源管理类接口单元p修订：在终端设备接口中补充终端类别属性字段；
7、0505计费帐务接口单元计费帐务接口单元p未做修订0606结算接口单元结算接口单元p未做修订07-07-营销与市场调查接口单元营销与市场调查接口单元p未做修订08-08-参数配置与计算原则接口单元参数配置与计算原则接口单元p新增接口：08118 打包产品构成，修订：08015 终端设备类别 准实时数据源接口能力支撑准实时数据源接口能力支撑 p经营分析系统数据源接口的传送周期需满足月、日、小时和分钟等多种周期。对于准实时数据源接口内容不同，对标准化传输的周期的迫切不同，本期规范要求数据源准实时接口支持到小时。p准实时数据源接口的数据获取最终取决源系统的系统提供能力。具体内容参见技术规范总册相关章
8、节。准实时数据源接口单元列表准实时数据源接口单元列表 目录目录1 1、总体说明、总体说明3 3、互动接口、互动接口2 2、数据源接口、数据源接口4 4、功能接口、功能接口互动接口总表互动接口总表（续）本数据服务的数据集及6个方法支撑对外部准实时数据提供的需求，“在线请求-同步响应”的消息交换模式即是准实时的，我们采用此交互模式，提高数据请求、数据查询、数据返回各个环节的效率，以达到准实时数据支撑的能力。具体技术实现方式参见技术规范总册“准实时数据提供章节”描述。营销服务互动服务营销服务互动服务p 营销服务互动服务的信息交换方式采用发布订阅方式。营销服务互动服务中的注册服务注册服务由服务提供方服
9、务提供方提供，通知服务通知服务由服务请求方服务请求方提供。支持营销服务互动服务数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。服务标识服务标识PublishSubscibeService服务描述服务描述注册服务由服务提供方提供。服务请求方调用注册服务，用于起订或退订具体的服务。注册服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。在注册服务的WSDL服务描述中需要列出可订阅数据集信息。实现方式实现方式基于SOAP的Web服务。性能要求性能要求单次请求正常网络通讯情况下，响应时间必须在2秒之内；同一时间内支持的最大并发请求小于100。方法标识方法标识Reg
10、isterRequest方法描述方法描述服务请求方调用注册服务（PublishSubscibeService）的注册方法（RegisterRequest），并发送请求消息给服务提供方。服务提供方订阅操作完毕，并返回应答消息给服务请求方。通知服务通知服务服务标识服务标识通知服务标识是由服务请求方在填写注册服务的请求信息中定义的。它是由注册服务（PublishSubscibeService）的注册方法（RegisterRequest）的请求消息中定义的通知服务标识（ServiceID）指定的。服务描述服务描述通知服务由服务请求方提供。服务提供方准备完数据，通过调用通知服务，告诉服务请求方数据准备完
11、毕。通知服务支持的数据集有营销互动、资费产品推荐互动、客户关怀互动、和策反互动等。实现方式实现方式基于SOAP的Web服务。性能要求性能要求单次请求正常网络通讯情况下，响应时间必须在2秒之内；同一时间内支持的最大并发请求小于100。方法标识方法标识通知服务方法标识是由服务请求方在填写注册服务的请求信息中定义的。它是由注册服务（PublishSubscibeService）的注册方法（RegisterRequest）的请求消息中定义的通知服务方法标识（FunctionID）指定的。方法描述方法描述服务提供方数据准备完毕后，调用服务请求方提供的通知服务方法并传递请求消息。服务请求方接收到通知，返回
12、应答消息给服务提供方。获取客户统一视图服务的新增内容p 在获取客户统一视图服务 增加两个新的方法：获取集团客户分析属性信息方法 获取集团成员分析属性信息方法 请求消息请求消息 获取集团客户分析属性信息方法 获取集团客户分析属性信息方法p 应答消息目录目录1 1、总体说明、总体说明3 3、互动接口、互动接口2 2、数据源接口、数据源接口4 4、功能接口、功能接口功能接口类别表省级经营分析系统与省级经营分析系统与4A4A安全平台接口安全平台接口p从帐号登录：从帐号登录：通过改造经营分析系统的认证管理模块、数据安全管理模块来实现4A管理平台与经营分析系统之间的单点登录（SSO）、集中认证，接收请求并
13、返回认证结果；p从帐号查询：从帐号查询：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号及属性的查询；p角色查询：角色查询：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中角色及属性的查询；p从帐号变更：从帐号变更：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号及属性的变更、同步；p角色变更：角色变更：通过改造经营分析系统的用户管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中角色及属性的变更、同步；p从帐号权限查询：从帐号权限查询：通过改造经营分析系统的权
14、限管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号角色关系、从帐号细粒度权限的查询；p角色权限查询：角色权限查询：通过改造经营分析系统的权限管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中角色的权限的查询；p从帐号角色变更：从帐号角色变更：通过改造经营分析系统的权限管理模块、数据安全管理模块来实现4A管理平台对经营分析系统中从帐号的角色关系变更、同步；p从帐号权限变更：从帐号权限变更：改造经营分析系统的权限管理模块、数据安全管理模块，实现通过4A管理平台对经营分析系统中从帐号细粒度权限变更；p审计日志传送：审计日志传送：通过改造经营分析系统的审计日志记录和数据安全
15、管理模块来实现4A管理平台对经营分析系统中登录记录和关键操作记录的过滤、格式化和发送。信息推送接口信息推送接口p 短信推送接口功能短信推送接口功能短信推送接口功能模块负责通过CMPP协议与短信网关交互，使经营分析门户的信息以短信方式发送给用户。短信通知接口支持短信的群发与定时发送，传输的内容包括发送流水号、手机号码、发送时间、发送内容、校验等。短信推送接口功能模块应有完善的系统出错处理机制，避免短信的漏发、错发，系统将对没有发送成功的信息进行缓存并进行多次重发。p 彩信推送接口功能彩信推送接口功能彩信推送接口功能负责与彩信网关交互，使经营分析门户可以把信息以彩信方式发送给用户。彩信推送接口传输内容包括流水号、手机号码、发送时间、彩信主题、图片长度、图片数据、文本长度、文本内容、音频长度、音频内容等。p 邮件推送接口功能邮件推送接口功能邮件通知接口负责与经营分析门户外的邮件服务器交互，使得经营分析门户可以把信息以邮件方式通过邮件服务器发出，应支持SMTP等协议。
