# 获取角色下的员工列表

# 中台代码

GetQwUserOfTeam

# 需求说明

1、企微任务系统需要对角色(目前只针对普通员工/管理者区分)进行鉴权,以便根据不同的角色显示不同的页面;
2、接入方系统需自行判断某个用户是"管理者"还是"成员",带上相应的模板tag(详情见返回参数的描述);

接入方与企微任务对接任务详情的时序图 image-20220531143342

# 请求方式

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 下属成员企微用户名