账户对接方案

金易联的员工人员信息，一般可以通过管理的方式通过Excel导入，这种手工导入方式支持用户的第一次导入。针对用户的一些信息可能存在变更或者新人的入职或者员工离职，需要对当前的人员信息进行同步更新，那么此时可以根据金易联提供的开放接口来进行员工信息的同步变更。

（1）在用户导入之前，需要先提供好员工的基础数据信息，以及每个人对应的组织信息；

（2）通过批量获取当前系统已有的组织信息，请求接口：GET {API_HOST}/api/v1/open/swan/manager/group 该接口会返回当前系统的组织信息；因为组织是一颗树状机构，所以需要根据当前的组织信息，构建一个树形的组织树；

（3）查看当前的组织名称，如果当前的组织名称在系统中不存在，则通过调用创建组织的接口来创建组织，请求接口：POST {API_HOST}/api/v1/open/swan/manager/group 该接口需要注意的是 一个组织的名称和父级组织的id，假如是第一层级的组织，则可以不传父级组织id。通过这样的方式，就可以把企业当前的组织目录导入到系统中，可以在本地并维护组织的名称和id的对应关系；

（4）在人员信息的同步中，因为存在岗位和角色的概念，员工的岗位信息也需要先进行导入操作，请求接口：GET {API_HOST}/api/v1/open/swan/manager/job 获取到系统当前的所有岗位信息，假如对应的岗位名称在系统不存在，则可以通过 POST {API_HOST}/api/v1/open/swan/manager/job ，只需要传入对应的岗位名称。

（5）在同步完岗位信息，还需要处理角色信息的同步，要获取当前系统中存在的角色信息，通过请求接口：GET {API_HOST}/api/v1/open/swan/manager/permission 该接口会返回当前系统的角色以及对应的权限信息，根据用户的需要，如果角色在系统中不存在，则可以进行添加创建，请求接口 POST {API_HOST}/api/v1/open/swan/manager/permission

（6）在人员的岗位、角色以及对应的组织信息都导入后，就可以开始进行人员信息的导入，通过GET {API_HOST}/api/v1/open/swan/manager/staff 可以拿到当前系统的人员信息。如果当前的用户在系统中不存在，则可以进行员工的添加，通过接口 POST {API_HOST}/api/v1/open/swan/manager/staff 进行员工信息的添加。一般情况下，通过account 的账号信息和开发者的员工系统工号进行一一对应。后续涉及到跨系统的交互，则通过传accout来实现关联操作。

通过上述的方式，可以把企业的账号信息通过接口导入到金易联系统中。