宽带商务和其它应用系统接口文档v2.2.docVIP

宽带商务与应用系统的接口 2010-12-13 宽带商务平台与联通的营业系统通过接口接收到业务开放、业务订购信息，在处理后，会产生相应的增值业务系统的业务订购关系信息，业务系统需要通过宽带商务平台提供的接口将这些业务订购关系信息同步到自身系统中，进行业务开放，也作为后续向最终用户提供服务的依据。 在最终用户通过宽带商务平台使用业务时，是通过增值业务系统的业务应用链接转到增值系统中使用业务，此时需要业务系统调用宽带商务平台提供的用户令牌验证签权接口，检验是否为真正有效的用户。 令牌验证签权接口 最终用户通过宽带商务平台使用业务时，增值业务系统调用宽带商务平台提供的用户令牌验证签权接口进行用户信息验证，并且根据返回结果判定是否提供服务。 接口定义 接口类型 Web Service 接口地址 由宽带商务平台提供测试环境：/sso/SSO.asmx正式环境：/sso/SSO.asmx 范围 名称 说明 Public [WebMethod] public string ValidToken(string strToken, string strMemo) 参数说明：1、strToken：令牌信息，在业务跳转链接中包含有此信息，调用时可直接使用；2、strMemo：备注信息。返回值： 0：表示验证成功，可提供服务； 1：表示验证失败，不允许提供服务。 用户业务信息同步接口 业务订购、变更信息通过BSS、OSS系统到达宽带商务平台中，在平台中处理后，会产生传递给增值业务系统的业务订购信息。增值业务系统通过调用用户业务信息同步接口可以得到用户订购信息。 接口定义 接口类型 Web Service 接口地址 由宽带商务平台提供测试环境：/sso/SSO.asmx正式环境：/sso/SSO.asmx 范围 名称 说明 Public [WebMethod] public string SyncInfo(string systemID, String strlastID, int iUserOrCorp, string strMemo) 参数说明：1、systemID：应用系统名，由宽带商务平台在系统；2、strlastID：上次成功同步的企业同步信息流水号或者用户同步信息流水号串 如“cid1,cid2,……”第一次为空；3、iUserOrCorp：标识同步企业数据、或者是用户数据,取值为（1：用户信息，2：企业信息）；4、strMemo：备注信息。 返回值： 返回字符串信息，如果调用成功，则根据参数iUserOrCorp返回企业数据信息、或者是用户数据信息，格式如后面的企业资料数据、用户资料数据所示； 如果调用失败，则返回错误信息描述的字符串。 接口特别说明： 如果在系统中需要失效时间，请把strMemo参数置为TRUE 返回字符串中是用分隔符来隔开数据信息：记录之间是“”号，字段之间“#”号； 同步企业信息时，strlastID为企业同步信息流水号串，同步用户信息时，strlastID为用于同步信息流水号串。 请先同步企业信息，再同步用户信息。 一次性更新十条信息。应用系统同步信息成功后要把企业同步信息流水号或者用户同步信息流水号串回传，用户平台将成功更新的信息删除。 如果是删除企业信息时,请也同时删除这个企业下的用户数据，平台不再对已经删除企业下的用户信息进行删除同步。 SP程序的每次运行时，应当调用数据同步接口多次（接口每次返回10条数据），应当调用接口直到返回数据为空，才算是完成一次数据同步。 企业资料数据 属性 类型 是否可空 备注 F_SN String N 企业同步信息流水号 f_OUdn String N 企业标识 f_OUID String N 企业编码ID f_OUName String Y 企业名称 f_OUFullName String Y 企业全名 f_ProductID String Y 业务套餐编号 f_UpdateOp String N 更新操作 +：增加； -：删除； M：修改 f_InvalidTime String Y 业务失效时间 用户资料数据 属性 类型 是否可空 备注 F_SN String N 用户同步信息流水号 f_username String N 用户账号 f_orderid String N 用户序号 f_Oudn String N 所属企业标识 f_region String Y 所属地区