移动－中央音乐平台三期全曲业务流程规范V1.16.doc

中央音乐平台外部总线下载平台流程接口规范中央音乐平台三期业务流程规范中国移动通信有限公司 发布修订记录revision record日期date修订版本revision version修改描述 change description作者author2008/04/101.00初稿完成刘杰奇2008-9-251.01将全曲的组装业务由外部总线移到内部总线完成王耀兴2008-10-151.05根据全曲业务平台要求，重新修订完毕文档刘杰奇2008-11-101.06根据全曲业务平台要求，和移动商议，对查询业务策略流程进行了修改和说明刘杰奇2008-11-181.08根据集团与合力的流程会议既要，确定了合力的下载流程刘杰奇2008-11-211.09与基地专家讨论后，优化流程和接口调用，对查询计费编码步骤在流程中的位置进行调后。刘杰奇2008-11-261.10增加了对全曲的24小时免费流程的说明：查询业务策略时，全曲业务平台自行判断是否免费，免费则直接告知门户其需要展示的信息；下载完成时，全曲业务平台同样需要判断是否免费，免费时直接返回，不需要通知平台计费。刘杰奇2008-12-021.11思特奇李阳评审后，对如下部分进行了修改1，2.3.2内容信息更新部分，对于各个子渠道的信息更新，改为由业务管理发起2，2.7.1请求下载的说明文字进行了修改，明确下载页面由门户提供王耀兴2008-12-031.12经三期例会讨论确定订购包月业务流程改为，内部总线先调用计费计费管理计费，再调用用户管理设置订购关系杨凌2008-12-031.13全曲确认下载2.6.2加上计费异步发起扣减高级用户使用优惠业务的请求流程杨凌2008-12-91.14修订了2.6.2确认下载的流程，在下载随机码和下载发生之间，增加了门户通知全曲下载会话以及相应的业务控制数据的流程。增加了2.12推荐章节，对于推荐的流程进行了说明。刘杰奇2009/1/61.15修订了2.6.2wap下载确认流程以及其说明，新增计费成功后通知门户的步骤。对原订购退订包月业务流程，由于订购和退订的流程差异较大，拆为两个不同的流程分别描述刘杰奇2009/1/121.16修订了所有确认订购时的计费流程，在计费时，首先更新会话，再通知用户管理。以防止会话更新失败导致的重复计费。刘杰奇2009/1/301.16修订了全曲内容分发，将分发到全曲和业务管理的流程分开，同时修正了内容分发部分的描述王耀兴2009/2/11.16修正了全曲确认下载步骤的流程图，将版权下发通知发起方从外部总线移到了内部总线，符合现网流程王耀兴2009/2/21.16修正了全曲内容分发部分的描述，不再区分试听文件，只区分实体文件（试听和播放文件总称）和铃音基本信息王耀兴目 录catalog中央音乐平台三期5全曲业务流程规范51概述61.1简介61.2体系架构图61.3组网方案61.4常用数据定义62全曲业务流程72.1业务分发72.2局数据上报72.3内容分发72.3.1内容创建以及文件更新72.3.2内容信息更新92.4业务订购与退定92.5业务计费112.5.1流量计费112.5.2当月计费112.5.3次月计费112.6wap门户全曲下载122.6.1查询业务策略122.6.2确认下载132.6.3错误重定向152.7web/sms门户全曲下载152.7.1请求下载152.7.2查询业务策略162.7.3确认下载162.7.4错误重定向162.8随身听全曲下载162.8.1查询业务策略162.8.2确认下载172.9用户直接使用下载地址进行下载182.10版权续订192.10.1查询业务计费策略192.10.2确认下载版权192.11全曲赠送202.11.1查询业务策略202.11.2请求赠送212.11.3被赠送方请求wap确认页面212.11.4确认下载222.11.5错误重定向222.12全曲推荐22中央音乐平台三期全曲业务流程规范关键词key words：摘 要abstract：描述了cms内容管理系统和其它外部部件之间的通知接口规范。缩略语清单list of abbreviations：abbreviations缩略语full spelling 英文全名chinese explanation 中文解释cmscontent management system内容管理系统enableenable业务部件,如download服务器等等cpcontent provider内容提供商spservice provider业务提供商1 概述1.1 简介本文档描述了中国移动中央音乐平台三期项目中，全曲业务的业务流程规范。1.2 体系架构图1.3 组网方案1.4 常用数据定义l 12位版权id：指内容管理模块在上传内容信息时生成的内容版权id，每个id对应一首具体的音乐某种应用，如彩铃，振铃，全曲等。但版权id无法进一步区别振铃高潮版、振铃普通版这样同属于振铃的两种不同应用形式。l 内容信息：内容管理模块上传内容信息时，管理员输入的该音乐内容的各种属性，如音乐名称，cp，sp版权时间，描述信息等等。l 18位内容id：内容管理模块在上传内容信息时，管理员指定的该内容的内容编码。对于每个不同的内容实体，都会对应一个编码。即，其对于彩铃高潮版、低潮版等，会因为流水号的不同而有差异。该编码主要用于drm加密，三期后，将用于drm、下载平台的业务产品标志的关键字。版权的具体业务应用形式。l 18位业务id：业务管理模块生成的，用于确定内容的业务计费方式，计费价格。业务id位18位，除了中央音乐平台之外，还会通知给boss。boss在计费时，会根据以前接受的业务id校验当前计费的业务id是否存在。l 下载随机码(事务id)：门户接到用户的下载请求时，由内部总线生成的下载事务id，用于对用户的操作行为进行校验，以及下载平台的下载事务校验，防止盗链以及非用户行为的计费发生。l 原始下载地址: 门户将内容发布到下载平台时，下载平台生成的，门户会分内容，分文件类型保存该地址。在用户请求wap确认(或是其他门户确认)页面时，门户会进行终端匹配，并确定文件的下载地址l 完整下载地址：在wap确认页面中供用户点击下载。2 全曲业务流程2.1 业务分发业务管理在创建新的包月业务信息的时候，需要将包月业务的相关信息通知到各个相关的业务模块和展示模块。2.2 局数据上报参考中央音乐平台三期彩铃业务流程规范中的彩铃局数据上报。2.3 内容分发2.3.1 内容创建以及文件更新本流程主要用于指导三期的内容创建和内容更新(涉及到实体文件的更新)流程。内容更新的时候，如果更新了实体文件（包括播放文件和试听文件），则需要通知下载平台，否则不需要通知下载平台。如果更新了实体文件和基本信息，则需要通知下载平台和门户以及其他展示平台。 步骤详解：1. 局数倨上报成功后，内容管理自动分发，或者是运营管理员以紧急分发的方式，指定局数据生效时间并执行分发。2. 内容管理将内容通过内、外部总线，将内容分发通知下发给下载平台。3. 下载平台收到通知后，检验文件是否存在，并返回通知接收结果。4. 下载平台获取内容后，通过外、内部总线发送下载分发回执通知给内容管理，知会相关内容的下载能力已经准备完毕。5. 内容管理通过内、外部总线，将内容分发给统一门户，由门户完成试听的加载，并根据渠道专属标志确认是否需要加载内容。6. 门户完成试听加载后，通过外、内部总线发送回执通知给内容管理，回执中包含该内容的试听地址。7. 内容管理收到门户(提供试听功能)的回执后，同时将内容分发到全曲业务平台和业务管理。8. 最后，由业务管理分发给渠道管理下的各个门户。2.3.2 内容信息更新在只修订了内容的信息描述，没有对试听和实体下载文件进行更新的时候的分发流程。流程说明：1. 内容管理在局数举上报完成后，发起内容分发请求2. 内容管理通过内外部总线将内容信息更新请求分发到门户3. 内容管理通过内外部总线将内容信息更新请求分发给全曲业务平台4. 内容管理通过内部总线直接将内容更新请求分发到业务管理(即渠道管理)，由业务管理下发到各子渠道。2.4 业务订购与退定2.4.1 业务订购用户在订购随身听业务，俱乐部包月业务的时候，需要调用中央音乐平台提供的接口，完成业务操作和当月月租业务扣费。对于包月业务的订购，用户管理在处理时，需要注意以下规则：l 如果用户退订，退订所有的该类包月产品，包括预订购产品。l 如果用户未订购任何包月产品，则用户可以任意订购一个包月产品，当月立即生效。l 如果用户已订购包月产品a，可以订购另一个包月产品b，当月包月产品a状态改为预退订，b是预订购状态。下月只保留b订购关系。l 如果用户已经订购了2个包月产品，当前月a(预退订)，下月b，再订购a，则a变成订购状态，下月b取消。l 预退订状态可以继续下载，并计费。l 如果用户订购一个包月产品，退订后变成预退订状态，再订购变成订购状态。l 如果用户预退订一个包月产品a，可以订购包月产品b。当月状态是预退订状态。下个月包月产品b生效。 步骤详解：1. 用户通过手机终端软件，或者在wap/web/sms等门户上订购业务。2. 各门户(或随身听proxy)调用全曲业务平台的业务订购接口3. 全曲业务平台转调外部总线提供的业务订购/退订的接口4. 外部总线需要通过调用内部总线提供的业务鉴权接口，对该业务订购进行检验。5. 内部总线调用业务管理的业务鉴权接口，判断该业务是否存在，该业务接入渠道是否合法。6. 内部总线调用用户管理的业务鉴权接口，判断用户是否已经订购了该业务，是否可以订购该业务。7. 如果业务鉴权和用户订购关系鉴权失败，直接返回失败结果和原因给各外部设备。8. 如果鉴权成功，根据请求来源，外部总线先到boss确定用户状态是否正常，若不正常直接返回失败结果给各外部设备。9. 如果用户状态正常，可以订购，则外部总线调用内部总线的业务/订购退订的接口。10. 内部总线通知用户管理记录或者修改用户的订购关系。11. 内部总线调用计费管理提供的计费接口。12. 用户管理需要通过内部总线发起(准异步机制)业务订购上报请求，通知boss用户订购的该包月业务。2.4.2 业务退订步骤详解：1. 用户通过手机终端软件，或者在wap/web/sms等门户上订购业务。2. 各门户(或随身听proxy)调用全曲业务平台的业务订购接口3. 全曲业务平台通过外部总线调用内部总线的订购退订包月业务接口。4. 内部总线判断是订购业务后，调用用户管理的设置订购关系接口，修改用户当前包月业务状态。并将结果通过接口调用的输出，反馈给全曲业务平台5. 用户管理异步方式通过内、外部总线，将退订信息上报给boss。2.5 业务计费2.5.1 流量计费目前针对全曲不收取流量费用。如果后续需要收取，可以通过控制完整下载地址中ip地址部分达到目的。详细说明参见中央音乐平台三期振铃和随身听业务流程规范中2.3流量计费；2.5.2 当月计费 当月计费在用户订购业务的时候，直接进行计费。参考2.3业务订购与退定。2.5.3 次月计费步骤详解：1. 用户管理负责根据各业务要求，每月生成待计费的用户业务订购关系话单。2. 用户管理生成话单后，通过内部总线，发送包月话单通知给计费管理3. 计费管理收到通知后，获取待计费的用户订购信息话单进行处理。2.6 wap门户全曲下载2.6.1 查询业务策略用户通过手机终端的wap功能，浏览音乐，并且选择音乐进行全曲下载。对于可下载的内容，用户点击下载后，wap门户首先提示用户下载的方式，价格，提示信息，以及确认按钮，供用户选择需要的计费策略并确认下载。如果用户欠费或者状态不正常，用户无法通过wap网关访问wap门户。如果是用户手机不支持的音乐内容，用户无法进行下载。步骤详解：1. 用户在终端收到的wap push链接地址上，点击请求wap门户展示下载确认页面。2. 门户进行终端适配，确保该内容支持该用户的手机终端。3. 门户调用全曲业务平台的查询业务策略接口。4. 全曲业务平台判断是否为免费策略(如24小时内免费重下机制)，如果是免费，全曲业务平台直接返回信息给门户。5. 如果需要收费，全曲业务平台调用外部总线对外统一提供的查询业务策略接口，以获取该内容针对用户的最终价格。6. 外部总线通过内部总线的查询业务策略接口进行策略查询操作。7. 内部总线到用户管理模块查询用户的基本信息。8. 内部总线将用户信息告知计费管理，由计费管理进行二次批价后，返回计费的策略信息给外部总线。外部总线将结果返回给全曲业务控制平台。9. 全曲业务控制平台需要根据门户的展示需要，从平台返回的业务策略信息中，组装业务策略编码。10. 全曲业务控制平台处理完毕后，返回给wap门户，后者根据展示需求，将业务策略id，描述信息等以wap确认页面的形式返回到用户终端的wap浏览器上。2.6.2 确认下载用户打开wap提示的确认页面后，在该页面上浏览下载相关信息、计费策略和价格信息，并选择相应的计费策略确认下载。在用户选择的是“包月并下载”这类计费策略时，门户需要先替用户订购相应的包月业务。再申请下载随机码，并通过该接口获取到真正的下载地址，最终由门户将用户终端重定向到下载平台完成实体文件的下载。实体文件下载完成后，由外部总线知会全曲业务平台下发版权并触发计费。这里由全曲业务平台统一判断用户是否处于24小时的免费期内，如果免费，则返回时告知外部总线该请求不触发计费。计费管理在处理时，如果下载是属于包月订购请求的下载，则计费管理只生成查询话单；如果属于按次订购请求，则需要生成计费话单；如果属于赠送请求的下载，则生成计费话单的时候，需要针对赠送方计费。详细的流程如下：步骤详解：1. 用户在手机终端的wap页面上，选择确认下载，终端请求首先发送到wap门户2. 门户向平台获取计费用的下载随机码(以完整下载地址的方式提供)。3. 门户收到下载地址后，向全曲业务平台通知下载会话以及业务相关信息。4. 门户向终端返回重定向请求，使终端重定向到获取到的下载地址(即实际下载地址)，链接到下载平台进行下载。5. 下载平台完成内容下载后，向外部总线报告下载结果；6. 如果下载成功，外部总线将下载结果上报给内部总线，由内部总线负责对下载的随机码(即下载会话id)和安全校验码(securityid)进行校验，并在校验后更新会话。7. 内部总线需要通知全曲业务平台下发版权，全曲业务平台实时返回消息处理结果，并反馈是否计费；8. 全曲业务平台通知drm下发版权。9. 版权下发完成后，全曲业务平台需要判断该用户是否在免费期内，如果是，则不需要上报给中央音乐平台计费；否则需要调用外部总线的音乐业务产品订购接口，请求计费；10. 外部总线上报音乐订购消息到内部总线；11. 内部总线收到音乐订购请求后，校验随机码，如果成功，通知计费管理进行扣费；12. 计费管理需要根据下载类型(赠送、包月、单次)针对相应的计费用户生成不同的话单以备查询或者计费；13. 内部总线收到计费管理的返回信息后，更新当前会话信息为已计费，并通知用户管理记载用户的业务产品订购记录；14. 内部总线通过外部总线通知门户计费结果。15. 如果需要扣减高级用户使用优惠次数的记录，计费需异步发起请求通过内部总线修改用户管理相应记录2.6.3 错误重定向用户终端上的地址是临时的下载地址，在超过一定时间(外部总线控制)后会失效。下载平台在收到用户手机的下载请求的时候，需要告诉手机终端重定向到门户的失败页面。终端会通过该重定向请求到门户获取一个wap页面(失败信息提示页面)。2.7 web/sms门户全曲下载2.7.1 请求下载 由于渠道的引入，本流程需要确定，wap页面的链接地址，也就是wap页面是由渠道自行提供还是12530的wap提供。无论哪种方式，web/sms门户或者渠道在生成地址时必须将自己的accessplatform参数传入；在展示和提交查询业务策略时，需要将该参数传递给中央音乐平台外部总线。这里需要确定的问题，所有wap请求如果都走外部总线的话，外部总线需要对外提供wap的能力接口，需要移动确认实现wap能力需要的编码。步骤详解：1. 用户通过web或者短信(sms)的方式，提交下载某个全曲业务产品的请求。2. web或者短信(sms)门户通过外部网关的wap发送能力，请求wap网关下发wappush请求，将wap确认的页面发送到用户手机上去。2.7.2 查询业务策略参见4.5.1查询业务策略2.7.3 确认下载参见4.5.2确认下载2.7.4 错误重定向参见4.5.3错误重定向2.8 随身听全曲下载2.8.1 查询业务策略 如果用户的账户状态不正常或者用户的号码欠费，都无法通过随身听软件访问中央音乐平台。但由于随身听的请求也是走wap网关过来的。在wap网关侧会对用户的状态进行判断，欠费用户是无法上wap的。因此，这里流程中不再体现用户状态的判断。随身听的查询业务策略流程与wap查询业务策略流程相似。由于目前的随身听终端在用户执行确认下载时，不方便进行重定向；因此，暂时安排先获取下载地址再提供下载；后续如果终端修正，支持重定向请求以后，随身听proxy仍然可以自行利用外部总线提供的查询下载地址接口，在用户确认之后再进行重定向。详细流程如下：步骤详解：1. 用户在手机终端收到的wap push链接地址上，点击请求wap门户展示下载确认页面。2. 随身听proxy进行终端适配，确保该内容支持该用户的手机终端。3. 随身听proxy调用全曲业务平台的查询业务策略接口。4. 全曲业务平台调用外部总线对外统一提供的查询业务策略接口。5. 外部总线通过内部总线的查询业务策略接口对策略进行统一调度。6. 内部总线内部总线到用户管理模块查询用户的基本信息。7. 内部总线将用户信息告知计费管理，由计费管理进行二次批价后，返回计费的策略信息给外部总线。外部总线将结果返回给全曲业务控制平台。8. 全曲业务控制平台需要根据随身听proxy的展示需要，从平台返回的业务策略信息中，组装业务策略编码，包括判断用户的本次下载是否可以免费。9. 全曲业务控制平台处理完毕后，返回给wap门户。10. 随身听proxy根据展示需求和终端软件的重定向能力，确定是否到平台申请下载随机码；11. 随身听proxy将业务策略id，描述信息等以wap确认页面的形式返回到用户终端的wap浏览器上。2.8.2 确认下载步骤详解：1. 用户在手机的随身听终端软件上确认执行下载，随身听终端软件使用下载地址直接链接到下载平台获取内容。2. 下载平台将内容以http方式下发到随身听终端。3. 下载平台下发完成后，将下发结果上报给外部总线，但由于http方式下载必须以终端上报的下载结果为准，因此这里外部总线不予处理。4. 终端软件发现下载完成，则上报下载完成通知给随身听proxy。5. 随身听proxy上报下载状态给外部总线，外部总线处理下载状态后，将通知全曲业务控制平台，由全曲业务控制平台通知drm下发版权。6. drm将版权信息以wap push的方式下发到用户的手机终端上，下发成功后，返回全曲业务控制平台版权下发完成。7. 全曲业务控制平台将下发结果等返回给门户和终端8. 全曲业务平台判断是否收费。如果不计费，则直接返回；9. 全曲业务平台判断需要计费，则调用外部总线提供的订购音乐业务产品接口。10. 外部总线将订购音乐产品消息转发给内部总线；11. 内部总线收到音乐订购请求后，通知计费管理下载完成，计费管理需要根据业务id和赠送号码判断(赠送、包月、单次)针对相应的计费用户生成不同的话单以备查询或者计费。12. 内部总线通知用户管理记载用户的业务订购关系，增加相应用户的积分。13. 内部总线处理完成后更新下载会话(下载会话由后台根据下载会话时间配置要求定时关闭)，将结果返回外部总线后。2.9 用户直接使用下载地址进行下载步骤详解：1. 用户在手机的wap浏览器上输入查找到的内容地址，并下载加密后的实体内容文件。2. 下载平台对该类地址进行判断，不进行校验，直接下载实体文件，下载完成后，不上报计费。3. 用户在使用实体文件时，需要下载版权，流程参见下面版权续订。2.10 版权续订2.10.1 查询业务计费策略用户手机播放时，如果发现没有版权或者版权过期，实现drm版权支持的手机终端会提示用户是否续费，用户确认时，自动打开wap页面，请求wap门户查询业务计费策略。详细流程参考2.6.1wap门户全曲下载之查询业务策略；2.10.2 确认下载版权用户在手机的wap界面上选择使用的计费策略，并确认下载。步骤详解：1. 用户在打开的wap确认页面上，确认下载版权。2. wap门户收到确认请求后，首先通过外部总线，到内部总线请求计费随机码，内部总线此时需要记录终端的一些必要信息。3. wap门户获取到随机码后，调用全曲业务平台的版权下发接口。4. 全曲业务平台通知drm下发版权，drm平台下发版权之后，将下发成功消息通知全曲业务平台；5. 全曲业务平台判断该请求是否需要计费，如果是必须要计费的，请求外部总线上报版权下载成功，请求计费；否则不予上报。6. 如果需要计费，外部总线收到上报消息后，调用内部总线的业务产品订购接口。7. 内部总线对业务产品订购接口终的计费随机码进行校验，判断其是否有效关闭，如果仍然有效，则通知计费管理计费。8. 内部总线到用户管理记录用户订购记录，并将最终的结果返回给外部总线9. 外部总线将计费结果返回给全曲业务平台。注:如果计费失败或者上报请求计费超时，全曲业务平台可以重新发起计费。2.11 全曲赠送2.11.1 查询业务策略用户可以通过web/sms/wap/ivr等方式，赠送一首全曲给自己的亲朋好友。当通过web、wap等方式进行操作时，赠送和下载一样，在用户确认业务操作前，需要先查询业务策略(价格)，以供用户选择和确认；目前赠送和下载业务策略是