2.3 获取员工详情 - 卫瓴API文档

请求参数

Query 参数

access_token

string

调用接口凭证

必需

userid

string

员工UserID

必需

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://openapi.weiling.cn/openapi/user/get?access_token&userid'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

userid

string

员工UserID

必需

wxcp_userid

string

企微员工ID

必需

name

string

员工名称

必需

mobile

string

必需

手机号码（需企微登录授权后才能返回）

depts

array [object {2}]

员工所属部门列表

必需

position

string

职务信息

必需

gender

integer

必需

性别。0表示未定义，1表示男性，2表示女性

email

string

邮箱

必需

avatar

string

头像url

必需

telephone

string

座机

必需

alias

string

别名

必需

status

integer

必需

企微激活状态: 1=已激活，2=已禁用，4=未激活，5=退出企业。

saas_status

integer

必需

卫瓴·企微助手的使用权限: 0-禁用 1-正常

qr_code

string

返回员工二维码

必需

extattr

object

可选

扩展属性，支持文本和网页两种类型

示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "userid": "suyore",
    "name": "张三",
    "mobile": "15517101234",
    "depts": [
      {
        "dept_id": "fdsfsflsjlj",
        "name": "研发"
      },
      {
        "dept_id": "cjvklxjfsoyi",
        "name": "产品"
      }
    ],
    "position": "",
    "gender": 1,
    "email": "abc@gmail.com",
    "avatar": "http://xxx.jpg",
    "telephone": "",
    "alias": "",
    "status": 1,
    "saas_status": 1,
    "qr_code": "http://sxssf.wjs.cn/aas.png",
    "extattr": {
      "attrs": [
        {
          "type": 0,
          "name": "文本名称",
          "text": {
            "value": "文本"
          }
        },
        {
          "type": 1,
          "name": "网页名称",
          "web": {
            "url": "http://www.test.com",
            "title": "标题"
          }
        }
      ]
    }
  }
}