对接联营Kit同步接口
前提条件
基础接口和Kit接口合计10个接口的生产地址路径保持一致。
- 基础接口:新购商品、商品续费、商品过期、商品资源释放、商品升级。
- Kit接口:租户信息同步接口、租户应用信息同步接口、租户应用授权信息同步接口、组织部门信息同步(增量)、组织部门信息同步(全量)。
接口 |
路径 |
---|---|
租户信息同步接口 |
/produceAPI/tenantSync |
租户应用信息同步接口 |
/produceAPI/applicationSync |
租户应用授权信息同步接口 |
/produceAPI/authSync |
组织部门信息同步(增量) |
/produceAPI/singleOrgSync |
组织部门信息同步(全量) |
/produceAPI/allOrgSync |
联营Kit接口描述请参见《云商店 接入指南》的联营Kit接口描述。
请求参数场景说明
租户信息同步接口/租户应用信息同步接口/组织部门信息同步(增量):
若接口请求参数的“flag”字段删除、修改或新增,服务商需要实现删除、修改或新增租户信息的业务逻辑。自测用例请参见云商店购买SaaS类应用绑定。
租户应用授权信息同步接口:
- 若接口请求参数的“flag”字段删除、修改或新增,服务商需要实现删除或新增租户信息的业务逻辑。自测用例请参见云商店购买SaaS类应用绑定。
- 下述两个场景需要用到扩展字段extension功能:
- ERP类应用,涉及到多账套的需通过扩展字段extension来传账套信息。
- 非ERP类应用,如果需要同步user扩展字段(如手机号、工号、邮箱等字段),可通过扩展字段来进行扩展传参,ISV端需要提前做好对接逻辑。扩展字段详细操作请参考企业租户将应用授权给下属的用户中的ERP类应用多账套或者扩展字段传参流程。
- 租户应用授权信息同步时,需要根据用户信息userList中的role参数描述的逻辑进行处理。
组织和账号同步说明
组织部门信息同步(增量)/组织部门信息同步(全量):
- 组织同步说明:
- 存量组织、账号同步说明:
- 应用涉及存量组织、账号同步
- 应用不涉及存量组织、账号同步
应用中的存量组织数据迁移,应用程序根据如下流程处理:
应用中的存量用户数据迁移,应用程序根据如下流程处理: