# 获取角色下的员工列表
# 中台代码
GetQwUserOfTeam
# 需求说明
1、企微任务系统需要对角色(目前只针对普通员工/管理者区分)进行鉴权,以便根据不同的角色显示不同的页面;
2、接入方系统需自行判断某个用户是"管理者"还是"成员",带上相应的模板tag(详情见返回参数的描述);
接入方与企微任务对接任务详情的时序图
# 请求方式
GET(HTTPS)
# 请求参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
app_id | string | 是 | 应用 id |
project_ids | []string | 否 | 项目 ID 列表 |
user_id | string | 是 | 用户 id |
state | string | 是 | 扩展参数 |
# 请求示例
{
"app_id": "39fdda6e-a341-5e67-e243-d4ec9da063b8",
"project_ids": ["7ea49153-ccbd-89d3-56a7-2137055498cb"],
"user_id": "zhouyong"
}
# 返回数据
{
"errcode": 0,
"errmsg": "ok",
"template_tag": "manager_task_detail",
"user_id": "zhouyong",
"user_name": "周勇",
"project_ids": ["7ea49153-ccbd-89d3-56a7-2137055498cb"],
"users": [
{
"user_id": "wangm",
"user_name": "王明"
}
]
}
# 返回参数说明
参数 | 类型 | 必须 | 说明 |
---|---|---|---|
errcode | int32 | 是 | 返回码。0 表示成功 |
errmsg | string | 是 | 对返回码的文本描述内容 |
template_tag | string | 是 | 模板 tag,manager_task_detail:管理者任务详情,member_task_detail:成员任务详情 |
user_id | string | 是 | 企微成员 id |
user_name | string | 是 | 企微成员用户名 |
project_ids | []string | 是 | 项目 id 列表 |
users.user_id | string | 是 | 下属成员企微 id |
users.user_name | string | 是 | 下属成员企微用户名 |