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