产品控制中心+-+授权接口文档

1、基础对象模型 版本历史版本更新日期更新内容更新人1.02009-11-10初始版本高良1.12009-11-141. 六个接口对服务授权是否存在，使用关系是否存在的判断变更2. 去掉使用关系表中服务授权ID字段3. 记录服务授权日志与业务同步执行高良1.22009-11-231. 原接口参数和返回值都为POJO，现在改为HashMap2. 当请求时间在上次服务时间之前或相等时，增加服务授权已过期的信息提示（1002） 详见附表高良1.32009-11-241. 产品控制中心所有返回代码前都加1例 1000 à 11000高良1. 产品控制中心授权接口1.1增加使用者调用形式：Hess

2、ian提供方： 产品中心调用方： 产品端接口名称：增加使用者接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeControllerService方法：public HashMap addUserPermission(HashMap paramMap);接口描述：产品端增加使用者对指定产品功能项的使用功能，产品中心为使用者开通授权服务注意：产品端在实现邀请用户业务时，也调用此接口，其中产品编号参数填写 基础产品编号接口时序图：接口参数：参数名称变量名参数类型参数说明可空addUserParam对象addUserParamObject提供给产品端的接

3、口的参数对象NaddUserParam对象解析：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString需要增加的产品编号N使用者列表userIdListList增加的使用者uid列表N接口返回对象：名称类型说明resultboolean成功:true失败:falseerrorCodeString错误代码11000 : 成功11001: 使用关系已存在12001 : addUserParam对象参数错误12002 : vaccountId参数错误12003 : 产品编号参数错误12004 : 使用者列表参数错

4、误13001 : 服务授权不存在19001 : 系统异常errorInfoString错误详细信息通知计费中心的参数：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString通知计费的产品编号N授权用户数userCountString服务授权记录对应的开通状态的使用关系数量N操作时间gmtOperateDate产品控制中心记录的授权时间N接口调用流程说明:1. 当产品端调用此接口增加使用者时，通过vaccountId和产品编号取得服务授权记录2. 若服务授权记录不存在，返回错误信息3. 查找使用关系记录，若已

5、存在会有提示，但不报错，状态更新为开通4. 若不存在使用关系则新增5. 记录授权日志6. 将使用关系数据同步到产品中心的cache中7. 通知产品端，服务授权成功8. 计算开通的授权用户数9. 通知计费中心授权用户数1.2删除使用者调用形式：Hessian提供方： 产品中心调用方： 产品端接口名称：删除使用者接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeControllerService方法：public HashMap delUserPermission(HashMap paramMap);接口描述：客户会对某付费产品删除使用者，产品控制中

6、心删除使用者对指定产品功能项授权注意：产品端在实现删除用户业务时，也调用此接口，其中产品编号参数填写 基础产品编号接口时序图：接口参数：参数名称变量名参数类型参数说明可空delUserParam对象delUserParamObject接口所需参数实体NdelUserParam对象解析：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString需要删除的产品编号N使用者列表userIdListList增加的使用者uid列表N接口返回对象：名称类型说明resultboolean成功:true失败:falseerro

7、rCodeString错误代码11000 : 成功11001：使用关系不存在12001 : delUserParam对象参数错误12002 : vaccountId参数错误12003 : 产品编号参数错误12004 : 使用者列表参数错误13001 : 服务授权不存在19001 : 系统异常errorInfoString错误详细信息通知计费中心的参数：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString通知计费的产品编号N授权用户数userCountString服务授权记录对应的开通状态的使用关系数量N操

8、作时间gmtOperateDate产品控制中心记录的授权时间N接口调用流程说明:1. 当产品端调用此接口删除使用者时，通过vaccountId和产品编号取得服务授权记录2. 若服务授权记录不存在，返回错误信息3. 查找使用关系记录，若不存在会有提示，但不报错4. 删除相应的使用关系记录5. 记录授权日志6. 将使用关系数据同步到产品中心的cache中7. 通知产品端，关闭服务授权成功 8. 计算开通的授权用户数9. 通知计费中心授权用户数1.3开通服务调用形式：Hessian提供方： 产品中心调用方： 订单系统接口名称：开通服务接口：com.alibaba.bss.pc2.server.rem

9、oting.IAuthorizeControllerService方法：public HashMap openService(ArrayList paramMapList);接口描述：客户自助开通产品服务时，订单系统调用此接口，产品中心为客户开通相应产品功能的授权接口时序图：接口参数：参数名称变量名参数类型参数说明可空List<openPerParam>openPerParamListList接口所需参数实体列表NopenPerParam对象解析：参数名称变量名参数类型参数说明可空授权使用标识permissionJsonjson开通服务时需要的业务参数组合成的json对象N产品编号

10、productCodeString产品编号NvaccountIdvaccountIdString虚拟帐号IDN来源sourceString值域枚举1：（订单系统）N业务IDbusinessIdString订单行号Y备注commentsString“开通服务”Y授权时间gmtAuthorizeDate授权时间YpermissionJson对象解析：参数名称变量名参数类型参数说明可空使用者列表userIdListpermissionJsonList自助开通的使用者列表格式"permissionJson":"userId1","userId2&quo

11、t;Y接口返回对象：名称类型说明resultboolean成功:true失败:falseerrorCodeString错误代码11000 : 成功11001：服务授权已开通11002: 服务授权已过期12001 : openPerParamList参数错误12002 : 产品编号参数错误12003 : vaccountId参数错误12004 : 来源参数错误 12005 : 业务ID参数错误 12006 : 备注参数错误12007 : 授权使用标识参数错误9001 : 系统异常errorInfoString错误详细信息通知计费中心的参数：参数名称变量名参数类型参数说明可空vaccountIdv

12、accountIdString虚拟帐号IDN产品编号productCodeString通知计费的产品编号N授权用户数userCountString服务授权记录对应的开通状态的使用关系数量N操作时间gmtOperateDate产品控制中心记录的授权时间N接口调用流程说明:1. 当订单系统调用此接口时，若使用者列表参数为空，则不增加使用关系2. 为此vaccountId创建服务授权记录（若已存在且为开通的状态，则会有提示，但不报错）3. 为所有使用者创建使用关系记录（若已存在且为开通的状态，则会有提示，但不报错）4. 记录授权日志5. 将使用关系数据同步到产品中心的cache中6. 返回通知产品端

13、，服务授权成功 7. 通知计费中心授权用户数1.4暂停服务调用形式：Hessian提供方： 产品中心调用方： 订单系统and计费中心接口名称：暂停服务接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeControllerService方法：public HashMap pauseService(ArrayList paramMapList);接口描述：订单系统：用户在产品端主动暂停付费产品，订单系统会通知产品控制中心，产品控制中心更新服务授权计费中心：公司欠费一段时间后，计费中心会通知产品控制中心关闭服务，产品控制中心关闭服务授权注意：计费中心欠

14、费关闭也调用此接口，在source参数中请调用方按枚举填写接口时序图：接口参数：参数名称变量名参数类型参数说明可空List<pausePerParam> pausePerParamListList接口所需参数实体列表NpausePerParam对象解析：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString需要暂停的产品编号N业务IDbusinessIdString订单行号或帐单明细IDY备注commentsString其它说明“自助暂停”，“欠费关闭”Y暂停时间gmtAuthorizeDate

15、订单系统挂起时间(用于记录到授权日志)计费中心可传欠费关闭时间Y来源sourceString值域枚举1：（订单系统） 2：（计费中心）N接口返回对象：名称类型说明resultboolean成功:true失败:falseerrorCodeString错误代码11000 : 成功11001 : 服务授权已暂停11002: 服务授权已过期12001 : pausePerParamList参数错误12002 : vaccountId参数错误12003 : 产品编号参数错误12004 : 来源参数错误12005 : 业务ID参数错误12006 : 备注参数错误13001：服务授权不存在19001 : 系

16、统异常errorInfoString错误详细信息接口调用流程说明:1. 当订单系统调用此接口暂停服务时通过vaccountId和产品编号取得服务授权记录2. 若服务授权不存在，返回错误信息3. 更新服务授权记录，状态变为关闭4. 更新所有相应的使用关系记录5. 记录授权日志6. 将使用关系数据同步到产品中心的cache中7. 通知产品端，服务授权暂停成功8. 通知计费中心授权用户数1.4恢复服务调用形式：Hessian提供方： 产品中心调用方： 订单系统and计费中心接口名称：恢复服务接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeContro

17、llerService方法：public HashMap reopenService(ArrayList paramMapList);接口描述：用户在产品端再次恢复之前目前被暂停的付费产品服务，订单系统会通知产品控制中心，产品控制中心更新服务授权计费中心：公司欠费被关闭服务，通过充值足够金额，销账成功后，计费中心通知产品控制中心开通服务注意：计费中心欠费关闭也调用此接口，在source参数中请调用方按枚举填写接口时序图：接口参数：参数名称变量名参数类型参数说明可空List<reopenPerParam> reopenPerParamListList接口所需参数实体NreopenPe

18、rParam对象解析：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString需要暂停的产品编号N业务IDbusinessIdString订单行号或，帐单明细IDY备注commentsString其它说明Y授权时间gmtAuthorizeDate授权时间Y来源sourceString值域枚举1：（订单系统） 2：（计费中心）N接口返回对象：名称类型说明resultboolean成功:true失败:falseerrorCodeString错误代码11000 : 成功11001 : 服务授权已开通11002: 服

19、务授权已过期12001 : reopenPerParamList参数错误12002 : vaccountId参数错误12003 : 产品编号参数错误12004: 来源参数错误12005 : 业务ID参数错误12006 : 备注参数错误13001：服务授权不存在19001 : 系统异常errorInfoString错误详细信息通知计费中心的参数：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString通知计费的产品编号N授权用户数userCountString服务授权记录对应的开通状态的使用关系数量N操作时间g

20、mtOperateDate产品控制中心记录的授权时间N接口调用流程说明:1. 当订单系统调用此接口恢复服务时通过vaccountId和产品编号取得服务授权记录2. 若服务授权不存在，返回错误信息3. 更新服务授权记录4. 更新所有相应的关闭状态的使用关系记录5. 记录授权日志6. 将使用关系数据同步到产品中心的cache中7. 通知产品端，服务授权成功8. 通知计费中心授权用户数1.5退订服务调用形式：Hessian提供方： 产品中心调用方： 订单系统接口名称：退订服务接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeControllerServ

21、ice方法：public HashMap refundService(ArrayList paramMapList);接口描述：用户在产品端自助退订付费产品服务，订单系统会通知产品控制中心，产品控制中心删除服务授权接口时序图：接口参数：参数名称变量名参数类型参数说明可空List<refundPerParam>refundPerParamListList接口所需参数实体列表NrefundPerParam对象解析：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString在虚拟帐号IDN产品编号productCodeString需要暂停的产品编号N来源sou

22、rceString值域枚举1：（订单系统）N业务IDbusinessIdString订单行号Y备注commentsString其它说明Y退订时间gmtAuthorizeDate订单系统的退订时间Y接口返回对象：名称类型说明resultboolean成功:true失败:falseerrorCodeString错误代码11000 : 成功11001：服务授权不存在11002: 服务授权已过期12001 : refundPerParamList参数错误12002 : vaccountId参数错误12003 : 产品编号参数错误12004 : 来源参数错误12005 : 业务ID参数错误12006 :

23、 备注参数错误19001 : 系统异常errorInfoString错误详细信息接口调用流程说明:1. 当订单系统调用此接口退订服务时通过vaccountId和产品编号取得服务授权记录2. 若服务授权不存在，会有提示，但不报错3. 删除service_id服务授权记录4. 删除service_id下所有的使用关系记录5. 记录授权日志6. 将使用关系数据同步到产品中心的cache中2. PC2依赖的外部接口2.1计费中心需要产品端提供一个接口：通知授权用户数2.2.1通知授权用户数具体参数(List<Object>类型)：参数名称变量名参数类型参数说明可空vaccountIdvaccountIdString虚拟帐号IDN产品编号productCodeString通知计费的产品编号N授权用户数currentNumString服务授权记