# 开放平台2.0操作文档

#一、开放平台2.0

1、连接平台------在连接平台引入连接器的概念，通过配置连接器能将数据传输到第三方平台当中，也能实现配置连接器实现薪事力单点登录到第三方系统；

2、API中心------这里有完整的薪事力开发者信息和接口信息，能在这里跳转到详细的API接口文档中，可供第三方平台安全调用，获取到薪事力的数据或写数据到薪事力。可以通过IP白名单，可限制第三方调用薪事力接口。

#二、开放平台2.0和1.0对比

# 三、注意事项

1、开放平台2.0受开放平台2.0license控制，需开通license才可使用，并且目前集团版只支持集团下有权限，子单位无法独立使用开放平台2.0。

2、同一个推送事件不能在2.0和1.0上同时配置，同时配置会出现重复推送数据到第三方平台上。

# 四、开放平台2.0操作说明

连接平台

连接平台主要用于配置第三方API接口文档相关信息实现集成需求。当调用第三方接口在薪事力通过事件触发实现数据推送、单点登录等，可以在连接平台下配置实现。连接平台目前主要功能有连接器管理。

连接器管理

1、数据推送

适用场景：

当与第三方系统集成，需要调用第三方API接口进行数据交互时，可以创建一个连接器，在连接器中配置好第三方接口鉴权信息，然后创建推送事件，当对应的薪事力执行某个事件的时候，就会自动触发推送数据到第三方系统当中，例如：添加部门的时候要把部门同步到第三方平台中，可以在这里配置连接器，在连接器中配置部门推送事件，就可以实现同步。

操作流程：

a、创建连接器，填写基础信息和鉴权设置

b、添加推送事件

c、配置推送事件

d、查看执行记录

2、单点登录

使用场景：

当薪事力需要集成第三方系统页面并且需要鉴权，实现在薪事力上单点登录时，可以创建一个连接器，在连接器中配置好鉴权方式，然后在系统设置------门户设置------自定义菜单中，新增菜单，菜单来源选择第三方鉴权，然后选择配置好的连接器，配置好好菜单后则实现单点登录第三方系统页面。

操作流程：

a、创建连接器，填写基础信息和鉴权设置

b、进入系统设置------门户设置------自定义菜单中，新增菜单，菜单来源选择第三方鉴权，选择刚刚创建的连接器。

c、进入菜单当中，点击此自定义菜单查看效果。

API中心

API中心主要规整了薪事力API接口文档相关内容，便于第三方调用薪事力接口实现集成需求，客户可对第三方调用者设置IP白名单，也能随时查看第三方调用薪事力接口的执行记录，更能保证系统安全。API中心主要功能有开发者信息、页面集成、接口管理、调用日志。

开发者信息

使用场景：

当第三方平台需要调取薪事力API接口进行交互前，需要做鉴权认证，只有提供给对方开发者信息才能鉴权认证通过。开发者信息分为默认开发者和自定义开发者。使用自定义开发者功能可以解决如下场景：

a、只允许第三方访问部分接口（例如只允许第三方访问劳动力管理的接口，其他的接口不对外开放）。

b、多个第三方和薪事力做集成时，可以限制每个第三方能访问的接口范围（例如OA系统只允许访问薪事力组织人事接口，财务系统只允许访问薪事力薪酬接口）。

c、限制第三方只允许在特定的网络下才允许访问接口。

操作流程：

默认开发者：

1、默认开发者在IP范围内，能访问系统内所有API接口。