2.4 根据条件获取员工详情

POST

https://openapi.weiling.cn/openapi/user/detail

请求参数

Query 参数

access_token

string

调用接口凭证

必需

Body 参数application/json

mobiles

array[string]

可选

手机号（mobiles、emails、names不可同时为空）注意: 不是企业微信后台员工手机号

emails

array[string]

可选

邮箱（mobiles、emails、names不可同时为空）注意: 不是企业微信后台员工邮箱

names

array[string]

可选

姓名（mobiles、emails、names不可同时为空）

示例

{
    "names": [
        "xxx",
        "xxx"
    ],
    "mobiles": [
        "186xxxxxxxx",
        "181xxxxxxxx"
    ],
    "emails": [
        "xxx@qq.com",
        "xxx@qq.com"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.weiling.cn/openapi/user/detail?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "names": [
        "xxx",
        "xxx"
    ],
    "mobiles": [
        "186xxxxxxxx",
        "181xxxxxxxx"
    ],
    "emails": [
        "xxx@qq.com",
        "xxx@qq.com"
    ]
}'

返回响应

🟢200成功

application/json

Body

msg

string

返回结果信息

必需

code

string

必需

返回结果码值-0:请求成功 500 系统错误 1001 参数错误

data

object

必需

data_list

array [object {14}]

用户列表

必需

示例

{
    "msg": "string",
    "code": "string",
    "data": {
        "data_list": [
            {
                "userid": "string",
                "wxcp_userid": "string",
                "name": "string",
                "mobile": "string",
                "depts": [
                    {
                        "dept_id": "string",
                        "name": "string"
                    }
                ],
                "position": "string",
                "gender": 0,
                "email": "string",
                "avatar": "string",
                "telephone": "string",
                "alias": "string",
                "status": 0,
                "saas_status": 0,
                "qr_code": "string"
            }
        ]
    }
}

修改于 2024-11-15 06:03:00

2.3 获取员工详情

2.5 获取员工ID列表