获取企微员工列表v2

更新时间：2025-04-15 17:17:59

接口说明

获取企微员工列表

基本信息

请求方式： POST

请求路径：

https://prod.open-api.mysre.cn/szmc/qw-nbd-api/get-qw-user-list-v2

请求参数

参数名 参数位置 参数类型 必填 默认值 示例 描述
app_id body string 是 企微中台应用 id
user_id body string 是 接入方后台用户 id
project_ids body array 是 项目 id 列表
scene body string 是 0-默认；1-拦截规则成员设置

请求示例

post /qw-nbd-api/get-qw-user-list-v2

返回成功示例

{
  "errcode": 0,
  "errmsg": "ok",
  "departments": [
    {
      "deptId": "部门001",
      "deptName": "部门名称001",
      "departments": [
        {
          "deptId": "部门001-子部门001",
          "deptName": "子部门001",
          "departments": [],
          "qwUsers": []
        }
      ],
      "qwUsers": [
        {
          "userId": "zhouyong",
          "userName": "周勇",
          "roles": [
            {
              "roleName": "经纪人"
            },
            {
              "roleName": "行销"
            }
          ]
        }
      ]
    }
  ],
  "qwUsers": [
    {
      "userId": "wangm",
      "userName": "王明",
      "roles": [
        {
          "roleName": "经纪人"
        }
      ]
    }
  ]
}

返回参数说明（成功）

参数名 参数类型 描述
errcode number
errmsg string
departments array
departments.deptId string
departments.deptName string
departments.departments array
departments.departments.deptId string
departments.departments.deptName string
departments.departments.departments array
departments.departments.qwUsers array
departments.qwUsers array
departments.qwUsers.userId string
departments.qwUsers.userName string
departments.qwUsers.roles array
departments.qwUsers.roles.roleName string
qwUsers array
qwUsers.userId string
qwUsers.userName string
qwUsers.roles array
qwUsers.roles.roleName string

失败返回示例

{}

返回参数说明（失败）

参数名 参数类型 描述

results matching ""

    No results matching ""