GLink平台开发者中心V2.0

# 组织用户

# 定义

# 组织用户

OrgUser

主键 类型 id 描述
主键 String id
编码 String code
类型 int type
名称 String name
父节点ID String parentId
全路径 String treePath
中文全路径 String namePath
维度ID String dimId
排序 int orderNum
全名 String fullName
组织层级 int levelType
二级集团单位标识 String providerId
虚拟组织机构标志 int virtually
性别 int gender
负责人标志 int leader
主岗位标志 int mainPosition
子列表 List <OrgUser> children

# 角色、角色组

Group

名称 类型 字段 描述
主键 String id
编码 String code
类型 int type
父节点ID String parentId
全路径 String treePath
所属应用ID String systemId
中文全路径 String namePath
子列表 List <Group> children

# 接口

# 根据组织维度获取组织/工程列表

  • 请求路径

    /pub/orgs/root

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织维度 String orgDim

  • 返回信息

    名称 类型 字段名 描述
    组织信息 List <OrgUser> orgUsers

# 按照组织ID获取当前组织详细信息

  • 请求路径

    /pub/orgs/{orgId}

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id String orgId
    维度 String dimId 1-工程树，2-组织树

  • 返回信息

    名称 类型 字段名 描述
    组织信息 OrgUser orgUser

# 在指定组织下搜索

搜索指定组织（数组）下组织（用户）

  • 请求路径

    /pub/orgs/users/search

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id List <String> orgIds 为空时从根节点开始
    名称 String name
    是否包含用户 int user 0 不包含，1 包含，默认0

  • 返回信息

    名称 类型 字段名 描述
    组织信息 List <OrgUser> orgUsers

# 获取组织下用户信息

  • 请求路径

    /pub/orgs/{orgId}/users/{userId}

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id String orgId
    用户id String userId

  • 返回信息

    名称 类型 字段名 描述
    用户信息 List <OrgUser> orgUsers

# 按照用户ID获取用户所属组织关系列表

  • 请求路径

    /pub/users/{userId}/orgs

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    用户id String userId

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 按照用户ID获取当前用户信息（包含当前用户的主要关系）

用户信息需带组织关系信息，通过main字段区分关系类型

  • 请求路径

    /pub/users/{userId}

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    用户id String userId
    包含用户主关系 int main 0 非主组织关系，1 主组织关系，默认1

  • 返回信息

    名称 类型 字段名 描述
    用户信息 List <OrgUser> orgUsers

# ***按照用户ID列表获取所查用户信息（新增）

用户信息需带组织关系信息，通过main字段区分关系类型

  • 请求路径

    /pub/selectListByUserIdList

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    用户id集合 List <String> userIdList 必输项
    包含用户主关系 int main 0 非主组织关系，1 主组织关系，默认1

  • 返回信息

    名称 类型 字段名 描述
    用户信息 List <OrgUser> orgUsers

# 按照组织ID获取当前组织的所有父节点信息

  • 请求路径

    /pub/orgs/{orgId}/parents

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id String orgId

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 按照组织ID获取当前组织下级组织与用户（参数标识是否包含用户,下钻一级）

  • 请求路径

    /pub/orgs/{orgId}/next

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id String orgId
    包含用户 int user 0 不包含用户，1包含用户，默认0

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 按照组织ID获取当前组织下所有用户（包含子级节点）

  • 请求路径

    /pub/orgs/{orgId}/users

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id String orgId

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# ***根据组织ID列表获取组织（用户）信息（新增）

  • 请求路径

    /pub/orgs/users/children

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织id列表 List <String> orgIdList 非必输
    姓名 String name 非必输
    查询的组织层级 int current 0所查子级组织（子级人员）,1所查子级组织（所查组织下全部人员，包含所有子级组织人员）,2所查组织（人员）,默认0
    是否查询用户 int user 0不包含用户信息，1包含，默认0

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 获取所有组织树（当前系统引用的）

  • 请求路径

    /pub/current/orgs/tree

  • 请求方法

    GET

  • 接口参数

    null

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 获取所有组织用户树（当前系统引用的）

  • 请求路径

    /pub/current/orgs/users/tree

  • 请求方法

    GET

  • 接口参数

    null

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 获取所有组织树（指定维度）

  • 请求路径

    /pub/orgs/tree

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织维度 String orgDim

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# 获取所有组织用户树（指定维度）

  • 请求路径

    /pub/orgs/users/tree

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织维度 String orgDim

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# ***根据条件获取组织(岗位)用户相关信息（新增）

  • 请求路径

    /pub/orgs/users/{deptId}

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织Id String deptId 必输项
    是否主部门 boolean isMainPosition false:查询所有部门的用户；true:查询主部门人员，默认false
    是否授信用户 boolean isBelieve false:查询全部用户；true:查询可信人员，默认false
    是否包含岗位 boolean isContainsPosition false:查询公司、机构用户；true:查询公司、机构及岗位人员，默认false
    是否包含子部门 int isContainsChildren 0：查询本部门用户；1：查询子部门用户；2：查询本部门及其子部门，默认0

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

# ***根据组织ID列表获取所需的组织信息（新增）

  • 请求路径

    /org/hr/selectListByOrgIdList

  • 请求方法

    GET

  • 接口参数

    名称 类型 字段名 描述
    组织ID集合 List <String> orgIdList 必输项
    姓名 String name

  • 返回信息

    名称 类型 字段名 描述
    组织用户列表 List <OrgUser> orgUsers

← 角色组角色 →