部门和成员操作

更新: 2018-6-4

成员和部门同步API

(注意: 以下接口需要先开通企业帐号同步功能才能使用)

企业成员和部门API

API域名

Host: yk3-api-ent.gokuai.com

添加或修改同步成员

POST /1/ent/add_sync_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
out_id 成员在外部系统的唯一ID
member_name 显示名称
account 成员在外部系统的登录帐号
member_email 邮箱
member_phone 联系电话
member_title 职位
password 如果需要由够快验证帐号密码,密码为必须参数
state - 帐号状态, 添加帐号时传1启用, 修改时, 0表示禁用帐号
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200

{
  "member_id": 用户ID(int),
  "state": 用户状态(int) //1表示启用, 0表示禁用
}

注意: 启用的帐号数如果超出企业帐号限制将会被强制禁用


删除同步成员

POST /1/ent/del_sync_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
dateline 当前unix时间戳, 单位秒
members 成员在外部系统的唯一ID, 多个用逗号,分隔
sign 签名

返回结果

HTTP 200


添加或修改同步部门

POST /1/ent/add_sync_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
out_id 部门在外部系统的唯一ID
name 显示名称
parent_out_id 如果部门在另一个部门的下级, 需要指定上级部门唯一ID, 不传表示在顶层; 修改时该字段用于移动部门, 空字符串表示移动到顶层
orderby 显示顺序, 按数值从小到大显示
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


删除同步部门

POST /1/ent/del_sync_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
groups 部门在外部系统的唯一ID, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


添加同步部门的成员

POST /1/ent/add_sync_group_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_out_id 部门在外部系统的唯一ID, 不传表示顶层
members 成员在外部系统的唯一ID, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


删除同步部门的成员

POST /1/ent/del_sync_group_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_out_id 部门在外部系统的唯一ID, 不传表示顶层
members 成员在外部系统的唯一ID, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


删除同步成员的所属部门

POST /1/ent/del_sync_member_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
members 成员在外部系统的唯一ID, 多个时用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


通过外部帐号获取成员信息

POST /1/ent/get_member_by_out_id HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
out_ids - 外部成员id, 多个用逗号,分隔
user_ids - 外部成员登录帐号, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

out_idsuser_ids 只需传其中一个

返回格式

json

返回结果

{
    "{out_id}":
    {
        "member_id": 成员ID,
        "account": 成员外部系统登录帐号,
        "member_name": 成员显示名,
        "member_email": 成员邮箱,
        "member_phone": 联系电话,
        "member_title": 职位,
        "state": 成员状态。1:启用,0:禁用
    },
    ...
}

添加管理员

POST /1/ent/add_sync_admin HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
out_id 成员外部系统唯一ID
member_email 成员邮箱
type 1表示超级管理员,0表示管理员
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


添加成员

POST /1/ent/add_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
account 登录帐号, 公有云必须是邮箱
password 初始密码
member_name 显示名称
member_phone 联系电话
member_title 职位
state 帐号状态, 1启用, 0禁用
group_path 成员所在部门路径
dateline 当前unix时间戳, 单位秒
sign 签名

其中部门路径是指部门层级关系, 如: 北京分公司/销售部

返回结果

HTTP 200

{
  "member_id": 用户ID(int),
  "state": 用户状态(int) //1表示启用, 0表示禁用
}

注意: 启用的帐号数如果超出企业帐号限制将会被强制禁用


修改成员

POST /1/ent/set_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
account 登录帐号
member_name 显示名称
member_phone 联系电话
member_title 职位
password 密码, 公有云不支持
state 帐号状态, 1启用, 0禁用
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200

{
  "member_id": 用户ID(int),
  "state": 用户状态(int) //1表示启用, 0表示禁用
}

删除成员

POST /1/ent/del_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
members 成员登录帐号, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


添加部门

POST /1/ent/add_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_name 显示名称
parent_group_path 如果部门在另一个部门的下级, 需要指定上级部门的部门路径, 不传或空字符串表示在顶层
orderby 显示顺序, 按数值从小到大显示
state 部门状态, 1启用, 0禁用
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200

{
    "group_id": 部门ID(int)
}

修改部门

POST /1/ent/set_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_path 需要修改的部门路径
group_name 显示名称
parent_group_path 移动部门, 指定上级部门路径, 空字符串表示移动到顶层
orderby 显示顺序, 按数值从小到大显示
state 部门状态, 1启用, 0禁用
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


删除部门

POST /1/ent/del_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
groups 需要修改的部门路径, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


添加部门成员

POST /1/ent/add_group_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_path 部门路径, 不传或传空字符串表示顶层
members 成员帐号, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


删除部门成员

POST /1/ent/del_group_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_path 部门路径, 不传或传空字符串表示顶层
members 成员帐号, 多个用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


删除成员的所属部门

POST /1/ent/del_member_group HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
members 成员帐号, 多个时用逗号,分隔
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


成员列表

POST /1/ent/get_members HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
start 记录开始位置, 默认0
size 返回条数, 默认20
dateline 当前unix时间戳, 单位秒
sign 签名

返回格式

json

返回结果

{
    list:
    [
        {
            "member_id": 成员ID,
            "out_id": 成员外部系统唯一ID,
            "account": 成员外部系统登录帐号,
            "member_name": 成员显示名,
            "member_email": 成员邮箱,
            "member_phone": 联系电话,
            "member_title": 职位,
            "state": 成员状态。1:启用,0:禁用,
        },
        ...
    ],
    count: 成员总数
}

成员信息

POST /1/ent/get_member HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
member_id - 成员ID
out_id - 成员外部系统唯一ID
account - 成员外部系统登录帐号
email - 普通公有云帐号通过登录邮箱查询
show_groups 是否返回成员所属部门; 1返回, 0不返回, 默认不返回
dateline 当前unix时间戳, 单位秒
sign 签名

注: 参数中的member_id, out_id, emailaccount必须传其中之一

返回格式

json

返回结果

{
    "member_id": 成员ID,
    "out_id": 成员外部系统唯一ID,
    "account": 外部系统登录帐号,
    "member_name": 成员显示名,
    "member_email": 成员邮箱,
    "member_phone": 联系电话,
    "member_title": 职位,
    "state": 成员状态。1:启用,0:禁用,
    "groups" :
    [
        {
            "id": 部门ID,
            "name": 部门名称,
            "group_code": 内部code,
            "out_id": 部门外部系统唯一ID
        },
        ...
    ]
}

部门列表

POST /1/ent/get_groups HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
dateline 当前unix时间戳, 单位秒
sign 签名

返回格式

json

返回结果

{
    "list":
    [
        {
            "id": 部门ID,
            "name": 部门名称,
            "out_id": 部门外部系统唯一ID,
            "parent_id": 上级部门ID, 0为顶层
        }
    ]
}

部门中成员列表

POST /1/ent/get_group_members HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
group_id 部门ID
group_path 部门路径
out_id 外部系统部门ID
show_child 1返回下层部门内的成员, 默认0不返回
start 记录开始位置, 默认0
size 返回条数, 默认20
dateline 当前unix时间戳, 单位秒
sign 签名

参数中group_id, out_id, group_path传其中一个即可

返回格式

json

返回结果

{
    list:
    [
        {
            "member_id": 成员ID,
            "out_id": 成员外部系统唯一ID,
            "account": 外部系统登录账号,
            "member_name": 成员显示名,
            "member_email": 成员邮箱,
            "member_phone": 联系电话,
            "member_title": 职位,
            "state": 成员状态。1:启用,0:禁用,
        },
        ...
    ],
    count: 成员总数
}

角色列表

POST /1/ent/get_roles HTTP/1.1

请求参数

参数 必需 说明
client_id 企业授权管理中获得的client_id
dateline 当前unix时间戳, 单位秒
sign 签名

返回格式

json

返回结果

[
    {
        "id": 角色ID,
        "name": 角色名称,
    },
    ...
]