部门和成员操作

更新: 2017-11-9

成员和部门同步API

企业成员和部门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 联系电话
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, 不传表示在顶层; 修改时该字段用于移动部门, 空字符串表示移动到顶层
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200

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

删除同步部门

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/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/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": 成员邮箱,
            "state": 成员状态。1:启用,0:禁用,
        },
        ...
    ],
    count: 成员总数
}

成员信息

POST /1/ent/get_member HTTP/1.1

请求参数

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

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

返回格式

json

返回结果

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

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

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": 成员邮箱,
        "state": 成员状态。1:启用,0:禁用
    },
    ...
}

部门列表

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
show_child 1返回下层部门内的成员, 默认0不返回
start 记录开始位置, 默认0
size 返回条数, 默认20
dateline 当前unix时间戳, 单位秒
sign 签名

返回格式

json

返回结果

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

角色列表

POST /1/ent/get_roles HTTP/1.1

请求参数

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

返回格式

json

返回结果

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