卫瓴API文档

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列表