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

基础对象模型 版本历史 版本 更新日期 更新内容 更新人 1.0 2009-11-10 初始版本 高良 1.1 2009-11-14 六个接口对服务授权是否存在，使用关系是否存在的判断变更 去掉使用关系表中服务授权ID字段 记录服务授权日志与业务同步执行 高良 1.2 2009-11-23 原接口参数和返回值都为POJO，现在改为HashMap 当请求时间在上次服务时间之前或相等时，增加服务授权已过期的信息提示（1002） 详见附表 高良 1.3 2009-11-24 产品控制中心所有返回代码前都加1 例 1000 ? 11000 高良 产品控制中心授权接口 1.1增加使用者 调用形式：Hessian 提供方： 产品中心 调用方： 产品端 接口名称：增加使用者 接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeControllerService 方法：public HashMap addUserPermission(HashMap paramMap); 接口描述：产品端增加使用者对指定产品功能项的使用功能，产品中心为使用者开通授权服务 注意：产品端在实现邀请用户业务时，也调用此接口，其中产品编号参数填写 基础产品编号 接口时序图： 接口参数： 参数名称 变量名 参数类型 参数说明 可空 addUserParam对象 addUserParam Object 提供给产品端的接口的参数对象 N addUserParam对象解析： 参数名称 变量名 参数类型 参数说明 可空 vaccountId vaccountId String 虚拟帐号ID N 产品编号 productCode String 需要增加的产品编号 N 使用者列表 userIdList List 增加的使用者uid列表 N 接口返回对象： 名称 类型 说明 result boolean 成功:true 失败:false errorCode String 错误代码 11000 : 成功 11001: 使用关系已存在 12001 : addUserParam对象参数错误 12002 : vaccountId参数错误 12003 : 产品编号参数错误 12004 : 使用者列表参数错误 13001 : 服务授权不存在 19001 : 系统异常 errorInfo String 错误详细信息 通知计费中心的参数： 参数名称 变量名 参数类型 参数说明 可空 vaccountId vaccountId String 虚拟帐号ID N 产品编号 productCode String 通知计费的产品编号 N 授权用户数 userCount String 服务授权记录对应的开通状态的使用关系数量 N 操作时间 gmtOperate Date 产品控制中心记录的授权时间 N 接口调用流程说明: 当产品端调用此接口增加使用者时，通过vaccountId和产品编号取得服务授权记录 若服务授权记录不存在，返回错误信息 查找使用关系记录，若已存在会有提示，但不报错，状态更新为开通 若不存在使用关系则新增 记录授权日志 将使用关系数据同步到产品中心的cache中 通知产品端，服务授权成功 计算开通的授权用户数 通知计费中心授权用户数 1.2删除使用者 调用形式：Hessian 提供方： 产品中心 调用方： 产品端 接口名称：删除使用者 接口：com.alibaba.bss.pc2.server.remoting.IAuthorizeControllerService 方法：public HashMap delUserPermission(HashMap paramMap); 接口描述：客户会对某付费产品删除使用者，产品控制中心删除使用者对指定产品功能项授权 注意：产品端在实现删除用户业务时，也调用此接口，其中产品编号参数填写 基础产品编号 接口时序图： 接口参数： 参数名称 变量名 参数类型 参数说明 可空 delUserParam对象 delUserParam Object 接口所需参数实体 N delUserParam对象解析： 参数名称 变量名 参数类型 参数说明 可空 vaccountId vaccountId String 虚拟帐号ID N 产品编号 productCode String 需要删除的产品编号 N 使用者列表 userIdList List 增加的使用者uid列表 N 接口返回对象： 名称 类型 说明 result boolean 成功:true 失败:false errorCode String 错误代码 11000 : 成功 11001：使用关系不存在 12001 : delUserParam对象参数错误