企微中台员工列表

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

接口说明

企微中台员工列表

基本信息

请求方式： GET

请求路径：

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

请求参数

参数名 参数位置 参数类型 必填 默认值 示例 描述
app_id query string 是 value1 企微中台应用 id
user_id query string 否 value2 接入方后台用户 id。用于接入方控制数据权限，此值是在嵌入页面插件时获取登录 Ticket 时传给企
project_ids query string 否 项目 id 列表 为空或不传时应返回所有项目的员工数据 #返回参数

请求示例

get /qw-nbd-api/get-qw-user-list?app_id=value1&user_id=value2&project_ids

返回成功示例

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

返回参数说明（成功）

参数名 参数类型 描述
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

失败返回示例

{
    "errcode": 500,
    "errmsg": "ok",
    "departments": [
        ]
}

返回参数说明（失败）

参数名 参数类型 描述
errcode number
errmsg string
departments array

results matching ""

    No results matching ""